Atualizar cargo

Este endpoint atualiza um cargo identificado pelo externalCode na URL.

Campos obrigatórios

name, similarity, externalCode: Não vazios.
jobLevel, description: Devem ser enviados; use null ou string vazia para limpar.

Exemplo de requisição (cURL)

curl --request PUT \
     --url 'https://api.gupy.io/os/v1/roles/external/RL-F98' \
     --header 'Content-Type: application/json' \
     --header 'Authorization: Bearer bearer_token_value_here' \
     --data '{
       "name": "Analista de Negócios Sênior",
       "similarity": "ANALYST",
       "externalCode": "RL-F98",
       "jobLevel": "SENIOR",
       "description": "Descrição atualizada"
     }'

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

Possíveis erros

Cargo não encontrado (404)

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

Código externo em uso por outro cargo (409)

{
  "message": "Another role in this company already uses this external code"
}

Updated about 14 hours ago