> ## Documentation Index
> Fetch the complete documentation index at: https://developers.tarefy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Associa clientes a um time em lote

> Exige a permissão TEAMS_MANAGE_CLIENTS (10026). O time deve pertencer à conta autenticada. Somente clientes ativos da mesma conta são adicionados; os demais candidatos são ignorados e contabilizados em data.summary.invalid. O processamento pode ter sucesso parcial ou não adicionar nenhum cliente. IDs positivos repetidos são deduplicados e vínculos existentes são preservados. Verifique status e summary no corpo: falhas de processamento, inclusive time inexistente ou de outra conta, também retornam HTTP 201 com status false e message.



## OpenAPI

````yaml /api-reference/workspace.yaml post /v2/teams/{teamId}/clients/bulk
openapi: 3.0.0
info:
  title: Tarefy API
  description: >-
    Tarefy REST API — task management, culture and performance platform.


    Endpoints are versioned at `/v2/...`. Authentication via Bearer JWT in the
    `Authorization` header.


    To get started, see the [authentication guide](/authentication) and the
    [quickstart](/quickstart).
  version: 2.0.0
  contact:
    name: Tarefy Support
    email: suporte@tarefy.com
    url: https://tarefy.com
  license:
    name: Proprietary
    url: https://tarefy.com
servers:
  - url: https://app.tarefy.com/nodeapi
    description: Production
security:
  - bearerAuth: []
tags:
  - name: User Data
    description: User personal data
  - name: User Profile
    description: Extended profile
  - name: User Documents
    description: Documents attached to the user
  - name: User Permissions
    description: User granular permissions
  - name: Teams
    description: Teams (user groups)
  - name: Orgchart
    description: Company organizational chart
  - name: Job Positions
    description: Available positions
  - name: Public EAP
    description: Public endpoints of the WBS
paths:
  /v2/teams/{teamId}/clients/bulk:
    post:
      tags:
        - Teams
      summary: Associa clientes a um time em lote
      description: >-
        Exige a permissão TEAMS_MANAGE_CLIENTS (10026). O time deve pertencer à
        conta autenticada. Somente clientes ativos da mesma conta são
        adicionados; os demais candidatos são ignorados e contabilizados em
        data.summary.invalid. O processamento pode ter sucesso parcial ou não
        adicionar nenhum cliente. IDs positivos repetidos são deduplicados e
        vínculos existentes são preservados. Verifique status e summary no
        corpo: falhas de processamento, inclusive time inexistente ou de outra
        conta, também retornam HTTP 201 com status false e message.
      parameters:
        - name: teamId
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - client_ids
              properties:
                client_ids:
                  type: array
                  minItems: 1
                  items:
                    type: integer
                  description: IDs dos clientes da mesma conta a vincular ao time.
      responses:
        '201':
          description: >-
            Resultado do processamento; consulte status e data.summary para
            distinguir sucesso, sucesso parcial e falha.
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    required:
                      - status
                      - message
                      - data
                    properties:
                      status:
                        type: boolean
                        enum:
                          - true
                      message:
                        type: string
                      data:
                        type: object
                        required:
                          - summary
                          - team
                        properties:
                          summary:
                            type: object
                            required:
                              - requested
                              - added
                              - alreadyInTeam
                              - invalid
                            properties:
                              requested:
                                type: integer
                                minimum: 0
                                description: >-
                                  Quantidade de IDs positivos distintos após
                                  normalização.
                              added:
                                type: integer
                                minimum: 0
                                description: Quantidade de clientes adicionados.
                              alreadyInTeam:
                                type: integer
                                minimum: 0
                                description: >-
                                  Quantidade de IDs solicitados já vinculados ao
                                  time.
                              invalid:
                                type: integer
                                minimum: 0
                                description: >-
                                  Candidatos não adicionados por inexistência,
                                  inatividade ou conta diferente.
                          team:
                            type: object
                            description: >-
                              Dados do time; os campos adicionais seguem o
                              formato legado.
                            properties:
                              id:
                                type: integer
                              name:
                                type: string
                  - type: object
                    required:
                      - status
                      - message
                    properties:
                      status:
                        type: boolean
                        enum:
                          - false
                      message:
                        type: string
              examples:
                partial:
                  summary: Sucesso parcial
                  value:
                    status: true
                    message: 1 cliente adicionado com sucesso
                    data:
                      summary:
                        requested: 3
                        added: 1
                        alreadyInTeam: 1
                        invalid: 1
                      team:
                        id: 42
                        name: Design
                failure:
                  summary: Time não encontrado
                  value:
                    status: false
                    message: >-
                      Time não encontrado ou você não tem permissão para
                      acessá-lo.
        '400':
          description: Corpo inválido; client_ids deve ser uma lista não vazia de inteiros.
        '401':
          description: Token ausente ou inválido.
        '403':
          description: Sem permissão para gerenciar clientes do time.
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.