Criar cargo

Campos obrigatórios

• name: Nome. Máximo de 300 caracteres.
• similarity: Similaridade (ex.: ANALYST, MANAGER, COORDINATOR, DIRECTOR).
• externalCode: Código externo. Máximo de 50 caracteres. Único entre cargos ativos.

Campos opcionais

• jobLevel: Nível (ex.: JUNIOR, MID_LEVEL, SENIOR, SPECIALIST). String vazia → null.
• description: Máximo de 900 caracteres.

Exemplo de requisição (cURL)

curl --request POST \
     --url 'https://api.gupy.io/os/v1/roles' \
     --header 'Content-Type: application/json' \
     --header 'Authorization: Bearer bearer_token_value_here' \
     --data '{
       "name": "Analista de Negócios",
       "similarity": "ANALYST",
       "externalCode": "RL-F98",
       "jobLevel": "MID_LEVEL",
       "description": "Cargo de analista"
     }'

Atenção: Forneça o token no cabeçalho Authorization.

Possíveis erros

Código externo já existente (409)

{
  "message": "A role with this external code already exists for your company."
}

Erro de validação (400)

Campos obrigatórios ausentes ou inválidos.