Listar cargos

Campos obrigatórios

Nenhum.

Campos opcionais (query)

• externalCode: Filtro (case-insensitive). Sem match → lista vazia.
• page: Padrão 1.
• maxPageSize: Padrão 10, máximo 100.
• expand: Relações adicionais (ex.: company,positions).

Exemplo de requisição (cURL)

curl --request GET \
     --url 'https://api.gupy.io/os/v1/roles?page=1&maxPageSize=10&expand=company,positions' \
     --header 'accept: application/json' \
     --header 'Authorization: Bearer bearer_token_value_here'

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

Possíveis erros

Não autenticado (401)

Token ausente ou inválido.