Pular para o conteúdo principal
PATCH
Atualizar uma Organização

Cabeçalhos

Content-Type
string

O tipo de mídia do recurso. O valor recomendado é application/json.

X-Request-Id
string<uuid>

Um identificador único utilizado para rastrear e acompanhar cada requisição.

Authorization
string

Token JWT bearer para autenticação. Obrigatório quando PLUGIN_AUTH_ENABLED=true (exigido em implantações multi-tenant). Opcional no modo OSS single-tenant padrão. Formato: Bearer <token>

Parâmetros de caminho

id
string<uuid>
obrigatório

O identificador único da Organização.

Corpo

application/json

A razão social da Organização.

Maximum string length: 256
parentOrganizationId
string<uuid> | null

O identificador único da Organização pai.

doingBusinessAs
string | null

O nome fantasia da Organização.

Maximum string length: 256
status
object

Um objeto contendo informações sobre o status. Importante: Se não fornecido, o status padrão será 'ACTIVE'.

address
object

Um objeto contendo informações sobre o endereço da Organização.

metadata
object

Um objeto contendo pares de chave-valor para adicionar como metadata, onde o campo name é a chave e o campo value é o valor. Por exemplo, para adicionar um Centro de Custo, use 'costCenter': 'BR_11101997'.

Restrições: as chaves devem ter no máximo 100 caracteres; valores de string no máximo 2000 caracteres. Objetos aninhados não são permitidos (os valores devem ser string, número ou booleano), a estrutura não pode exceder uma profundidade máxima de 10, e é permitido um máximo de 100 chaves.

Resposta

Indica que a requisição foi bem-sucedida e a resposta contém os dados esperados.

id
string<uuid>

O identificador único da Organização.

A razão social da Organização.

Maximum string length: 256
parentOrganizationId
string<uuid> | null

O identificador único da Organização pai.

doingBusinessAs
string | null

O nome fantasia da Organização.

Maximum string length: 256

CPF, CNPJ ou outro documento de identificação legal da organização.

Maximum string length: 256
Exemplo:

"123456789012345"

status
object

Um objeto contendo informações sobre o status.

address
object

Um objeto contendo informações sobre o endereço da Organização.

metadata
object

Um objeto contendo pares de chave-valor para adicionar como metadata, onde o campo name é a chave e o campo value é o valor. Por exemplo, para adicionar um Centro de Custo, use 'costCenter': 'BR_11101997'.

Restrições: as chaves devem ter no máximo 100 caracteres; valores de string no máximo 2000 caracteres. Objetos aninhados não são permitidos (os valores devem ser string, número ou booleano), a estrutura não pode exceder uma profundidade máxima de 10, e é permitido um máximo de 100 chaves.

createdAt
string<date-time>

Data e hora de criação (UTC).

updatedAt
string<date-time>

Data e hora da última atualização (UTC).

deletedAt
string<date-time> | null

Data e hora da exclusão lógica, se aplicável (UTC).