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

# Alterar centro de custo em lote

> Aplica um centro de custo a várias linhas de uma vez. A requisição é aceita por inteiro ou recusada por inteiro: se alguma linha ou o centro de custo não pertencer à sua empresa, nada é alterado. As linhas são atualizadas em segundo plano; a resposta traz o ID de uma tarefa para acompanhar o resultado em GET /tasks/{id}.



## OpenAPI

````yaml api-reference/v3/openapi.json POST /api/v3/phone-accounts/batch-update-cost-center
openapi: 3.1.0
info:
  version: v3
  title: Salvy API
  x-logo:
    url: web/logo.png
servers:
  - url: https://api.salvy.com.br
    description: Salvy API URL
security:
  - bearerAuth: []
tags:
  - name: Public API
  - name: Outgoing Webhooks
paths:
  /api/v3/phone-accounts/batch-update-cost-center:
    post:
      tags:
        - Public API
      description: >-
        Aplica um centro de custo a várias linhas de uma vez. A requisição é
        aceita por inteiro ou recusada por inteiro: se alguma linha ou o centro
        de custo não pertencer à sua empresa, nada é alterado. As linhas são
        atualizadas em segundo plano; a resposta traz o ID de uma tarefa para
        acompanhar o resultado em GET /tasks/{id}.
      operationId: publicBatchUpdatePhoneAccountsCostCenterV3
      parameters:
        - name: idempotency-key
          in: header
          required: false
          schema:
            $schema: https://json-schema.org/draft/2020-12/schema
            description: >-
              Idempotency key for this request. Will return the same response if
              the same request is made again with the same key. Fails if
              parameters are different.
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $schema: https://json-schema.org/draft/2020-12/schema
              type: object
              properties:
                phoneAccountIds:
                  minItems: 1
                  maxItems: 1000
                  type: array
                  items:
                    type: string
                  description: >-
                    IDs das linhas que recebem o centro de custo, até 1.000 por
                    requisição. Todas devem pertencer à sua empresa; se alguma
                    não pertencer, nenhuma é alterada. IDs repetidos são
                    considerados uma vez.
                  example:
                    - 0140a8c6-3815-45b7-9e60-8e137cad845c
                costCenterId:
                  description: >-
                    ID do centro de custo aplicado às linhas; consultável em GET
                    /cost-centers. Envie `null` para remover o centro de custo
                    das linhas.
                  example: 0198c2f1-3815-45b7-9e60-8e137cad845c
                  type:
                    - string
                    - 'null'
              required:
                - phoneAccountIds
                - costCenterId
              additionalProperties: false
        required: true
      responses:
        '202':
          description: ''
          content:
            application/json:
              schema:
                $schema: https://json-schema.org/draft/2020-12/schema
                type: object
                properties:
                  taskId:
                    type: string
                    format: uuid
                    pattern: >-
                      ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                    description: >-
                      ID da tarefa que aplica a alteração; acompanhe o resultado
                      em GET /tasks/{id}.
                    example: 0f9c1b2e-5d3a-4f8b-9c7e-1a2b3c4d5e6f
                required:
                  - taskId
                additionalProperties: false
        '400':
          description: ''
          content:
            application/json:
              schema:
                $schema: https://json-schema.org/draft/2020-12/schema
                type: object
                properties:
                  code:
                    type: string
                    enum:
                      - idempotency-parameters-mismatch-error
                      - idempotency-invalid-header-error
                  message:
                    type: string
                required:
                  - code
                  - message
                additionalProperties: {}
        '401':
          description: ''
          content:
            application/json:
              schema:
                $schema: https://json-schema.org/draft/2020-12/schema
                type: object
                properties:
                  code:
                    type: string
                    enum:
                      - unauthorized
                  message:
                    type: string
                required:
                  - code
                  - message
                additionalProperties: {}
        '403':
          description: ''
          content:
            application/json:
              schema:
                $schema: https://json-schema.org/draft/2020-12/schema
                type: object
                properties:
                  code:
                    type: string
                    enum:
                      - forbidden
                      - resources-not-authorized
                      - insufficient-scope
                  message:
                    type: string
                required:
                  - code
                  - message
                additionalProperties: {}
        '404':
          description: ''
          content:
            application/json:
              schema:
                $schema: https://json-schema.org/draft/2020-12/schema
                type: object
                properties:
                  code:
                    type: string
                    enum:
                      - resource-not-found
                  message:
                    type: string
                required:
                  - code
                  - message
                additionalProperties: {}
        '413':
          description: ''
          content:
            application/json:
              schema:
                $schema: https://json-schema.org/draft/2020-12/schema
                type: object
                properties:
                  code:
                    type: string
                    enum:
                      - payload-too-large
                  message:
                    type: string
                required:
                  - code
                  - message
                additionalProperties: {}
        '422':
          description: ''
          content:
            application/json:
              schema:
                $schema: https://json-schema.org/draft/2020-12/schema
                type: object
                properties:
                  code:
                    type: string
                    enum:
                      - input-validation-error
                      - unprocessable-entity
                      - phone-account-batch-validation-failed
                      - company-not-active
                  message:
                    type: string
                  details:
                    type: array
                    items:
                      type: object
                      properties:
                        key:
                          type: string
                        message:
                          type: string
                      required:
                        - key
                        - message
                      additionalProperties: false
                required:
                  - code
                  - message
                additionalProperties: {}
        '429':
          description: ''
          content:
            application/json:
              schema:
                $schema: https://json-schema.org/draft/2020-12/schema
                type: object
                properties:
                  code:
                    type: string
                    enum:
                      - too-many-attempts
                  message:
                    type: string
                required:
                  - code
                  - message
                additionalProperties: {}
        '500':
          description: ''
          content:
            application/json:
              schema:
                $schema: https://json-schema.org/draft/2020-12/schema
                type: object
                properties:
                  code:
                    type: string
                    enum:
                      - unknown
                  message:
                    type: string
                required:
                  - code
                  - message
                additionalProperties: {}
      deprecated: false
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: key

````

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