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

# Transfere colaboradores para o calendário informado. Se dataInicio for ausente ou igual a hoje, executa imediatamente. Datas futuras criam agendamento (processado por cron diário).



## OpenAPI

````yaml https://api.pre.pontua.tech/api/public/doc-json post /calendarios/{calendarioId}/colaboradores/transferir
openapi: 3.0.0
info:
  title: Pontua Public API
  description: >-
    API oficial da Pontua para integrações de clientes externos. Autentique com
    o token gerado no dashboard em **Configurações → API**. Envie o token no
    header `Authorization: Bearer <SEU_TOKEN>`.
  version: '1.0'
  contact: {}
servers: []
security: []
tags: []
paths:
  /calendarios/{calendarioId}/colaboradores/transferir:
    post:
      tags:
        - Calendário
      summary: >-
        Transfere colaboradores para o calendário informado. Se dataInicio for
        ausente ou igual a hoje, executa imediatamente. Datas futuras criam
        agendamento (processado por cron diário).
      operationId: CalendariosController_TransferirColaboradores
      parameters:
        - name: calendarioId
          required: true
          in: path
          description: ID do calendario
          schema:
            type: string
      requestBody:
        required: true
        description: Lista de colaboradores e data de início (opcional)
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TransferirColaboradoresRequestDto'
      responses:
        '201':
          description: Resultado da transferência (imediata ou agendada)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TransferirColaboradoresResponseDto'
        default:
          description: "\n\t\t\t400 - Bad Request: A solicitação não está no formato correto.\n\t\t\t401 - Unauthorized: A solicitação não foi autorizada. Verifique se o token de acesso é válido.\n\t\t\t403 - Forbidden: Acesso proibido! Requer um nível de permissão mais elevado.\n\t\t\t404 - Not Found: O recurso solicitado não foi encontrado.\n\t\t\t500 - Internal Server Error: Erro de execução no servidor!\n\t\t\t"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDto'
      deprecated: false
      security:
        - bearer: []
components:
  schemas:
    TransferirColaboradoresRequestDto:
      type: object
      properties:
        colaboradorIds:
          description: IDs dos colaboradores a transferir (mínimo 1, máximo 500)
          example:
            - 7b3c4d5e-6f7a-8b9c-0d1e-2f3a4b5c6d7e
          type: array
          items:
            type: string
        dataInicio:
          type: string
          description: >-
            Data de início da transferência (ISO yyyy-MM-dd). Ausente OU igual a
            hoje = transferência imediata. Maior que hoje = agendado.
          example: '2026-05-01'
        motivo:
          type: string
          description: Motivo da transferência (audit log opcional)
          maxLength: 500
      required:
        - colaboradorIds
    TransferirColaboradoresResponseDto:
      type: object
      properties:
        status:
          type: string
          description: Status da transferência
          enum:
            - completed
            - scheduled
          example: completed
        colaboradoresAfetados:
          type: number
          description: Quantidade de colaboradores afetados
        agendamentoId:
          type: string
          description: >-
            Identificador do agendamento (presente apenas quando
            status=scheduled)
          nullable: true
        dataExecucao:
          format: date-time
          type: string
          description: >-
            Data de execução do agendamento (presente apenas quando
            status=scheduled)
          nullable: true
        executedAt:
          format: date-time
          type: string
          description: Timestamp da execução (presente apenas quando status=completed)
          nullable: true
      required:
        - status
        - colaboradoresAfetados
    ErrorDto:
      type: object
      properties:
        service:
          type: string
          description: Rota solicitada
        method:
          type: string
          description: Método http
        message:
          description: Mensagem do erro
          oneOf:
            - type: string
              example: message erro
            - type: array
              items:
                type: string
                example:
                  - erro 1
                  - erro 2
      required:
        - service
        - method
        - message

````