Skip to main content
POST
cURL

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

idempotency-key
string

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.

Body

application/json
code
string
required

Código do centro de custo definido pela empresa.

Minimum string length: 1
Example:

"ENG-01"

name
string
required

Nome do centro de custo.

Minimum string length: 1
Example:

"Engenharia"

status
enum<string>

Situação do centro de custo: "active" (em uso) ou "disabled" (desativado pela empresa). Quando omitido, o centro de custo nasce "active".

Available options:
active,
disabled
Example:

"active"

responsibleEmployeeId
string

ID do colaborador responsável pelo centro de custo.

Example:

"0197aa3e-3815-45b7-9e60-8e137cad845c"

Response

id
string
required

Identificador único do centro de custo.

Examples:

"123e4567-e89b-12d3-a456-426614174000"

"123e4567-e89b-12d3-a456-426614174001"

companyId
string
required

ID da empresa dona do centro de custo.

Examples:

"123e4567-e89b-12d3-a456-426614174000"

"123e4567-e89b-12d3-a456-426614174001"

code
string | null
required

Código do centro de custo definido pela empresa. Nulo quando o centro de custo não tem código.

Example:

"ENG-01"

name
string
required

Nome do centro de custo.

Example:

"Engenharia"

status
enum<string>
required

Situação do centro de custo: "active" (em uso) ou "disabled" (desativado pela empresa).

Available options:
active,
disabled
Example:

"active"

responsibleEmployee
object | null
required

Colaborador responsável pelo centro de custo. Nulo quando não há responsável definido.