Deletar cargo

Este endpoint realiza soft delete de um cargo pelo externalCode.


Regras de negócio e restrições

A exclusão não é permitida se o cargo possuir posições vinculadas.

Exemplo de requisição (cURL)

curl --request DELETE \
     --url 'https://api.gupy.io/os/v1/roles/external/RL-F98' \
     --header 'accept: application/json' \
     --header 'Authorization: Bearer bearer_token_value_here'

Atenção: Substitua RL-F98 pelo código externo.

Possíveis erros

Cargo não encontrado (409)

{ "message": "The role you are looking for does not exist" }

Cargo com relacionamentos ativos (422)

{ "message": "The given role has active relationships" }