Remover contrato de um cliente

DELETE

/v2/clients/{clientId}/contracts/{contractId}

Remove o contrato informado em contractId do cliente. A remoção é lógica: o contrato deixa de aparecer na listagem e nos detalhes, e as matrículas que estavam vinculadas a ele continuam existindo, agora sem contrato. A resposta é 200 com message contendo "Contrato deletado com sucesso.". Contrato inexistente ou já removido devolve 500 (Não foi possível deletar o contrato.). Requer autenticação via Bearer JWT ou header x-api-key e a permissão de excluir contratos de clientes. O cliente precisa pertencer à empresa do usuário: cliente inexistente devolve 404 (Cliente não encontrado), cliente de outra empresa devolve 401 (Acesso negado) e usuário inativo devolve 404 (Usuário não encontrado). Usuário sem perfil de permissão recebe 403 (Acesso negado); perfil inexistente, 401 (Permissão inválida!); perfil sem a permissão, 400 (Permissão não encontrada).

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros de Caminho

Parâmetros Header

Respostas

🟢200

application/json

Contrato removido

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠404NotFound

🟠429TooManyRequests

🔴500InternalError

🟠400Sem permissão para excluir contratos

🟠403Acesso negado

🔴500Falha ao remover o contrato

Request Example

Shell

JavaScript

Java

Swift

curl --location --request DELETE '/v2/clients/7c9e6679-7425-40de-944b-e07fc1f90ae7/contracts/3f6b1d2e-8c4a-4b7e-9d1a-5e2c7a9b0f13' \
--header 'x-api-key: SUA_CHAVE_DE_API' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Sucesso

{
    "message": [
        "Contrato deletado com sucesso."
    ]
}

Modificado em 2026-10-13 09:47:06

Página anterior

Exportar conferência de matrículas de um contrato (CSV)

Próxima página

Comparar contrato com uma matrícula vinculada