Trocar a empresa principal

PATCH

/api/v2/cliente-empresas/by-cliente/{idCliente}/principal

Torna uma empresa já vinculada a principal do cliente. A anterior continua
vinculada, como secundária.

Regras

id_empresa_esperada é obrigatório: a principal que você leu, ou null
se o cliente não tinha. Se ela não for mais a atual, a resposta é 409 com o
nome da principal de agora — releia e tente de novo.

A empresa precisa estar vinculada ao cliente; para vincular e tornar principal
de uma vez, use POST com principal: true.

O vínculo e a empresa precisam estar ativos.

Se a empresa já é a principal, nada muda e a resposta é 200.

A troca vale para os tickets abertos depois dela.

Requisição

Parâmetros de Caminho

Parâmetros Header

Parâmetros Bodyapplication/jsonObrigatório

Examples

Respostas

🟢200OK

application/json

Principal definida.

Bodyapplication/json

🟠400Pedido Inválido

🟠401Não Autorizado

🟠404Registo Não Encontrado

🟠409

🟠422Erro de Parâmetro

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PATCH '/api/v2/cliente-empresas/by-cliente/4520/principal' \
--header 'api-key: {{api-key}}' \
--header 'Content-Type: application/json' \
--data '{
    "id_empresa": 12,
    "id_empresa_esperada": 3
}'

Response Example

200 - Principal trocada

{
    "ok": true,
    "data": {
        "id_cliente": 4520,
        "id_empresa": 12
    }
}

Modificado em 2026-11-04 02:31:07

Página anterior

Vincular empresa ao cliente

Próxima página

Alterar tipo de relacionamento

Trocar a empresa principal

Regras#

Requisição

Respostas

Regras