Menu da documentação

unauthenticated

HTTP 401 · Não autenticado


HTTP	`401`
`title`	Não autenticado
`detail`	Sem `detail`

Quando acontece: sem Authorization: Bearer …; token inválido ou expirado (vale 1 h); client revogado no painel; client sem tenant dono.

O que fazer: peça um token novo em POST /oauth/token e repita a chamada. Se continuar, confira se o client não foi revogado. Renove o token antes de expirar (expires_in) em vez de esperar o 401.

Exemplo da resposta

application/problem+json

{
    "type": "https://sandbox.pagaki.com.br/errors/unauthenticated",
    "title": "Não autenticado",
    "status": 401,
    "code": "unauthenticated",
    "request_id": "01JBZ3Q2W5E8R1T4Y7K0M3N6P9"
}

Decida pelo code, que é estável; o detail pode mudar de texto. Guarde o request_id para falar com o suporte. Todos os erros.