unauthorized

Falta la credencial o no es válida.

HTTP	code	¿Reintentable?
401	unauthorized	no

Cuándo ocurre

No enviaste Authorization: Bearer, la llave es desconocida, o una operación firmada llegó sin X-API-Key + JWT.

Valores de reason

En una operación firmada, X-API-Key toma el prefijo de la llave, no el secreto completo. Si envías el secreto completo, no resuelve ninguna llave y recibes este error con detail: "Unknown API key." — no invalid_signature.

reason	Significado
signed_jwt_on_bearer_route	Firmaste un endpoint de Nivel 1. Tu llave está bien: sobra la firma. Reenvía con Authorization: Bearer <secreto> y sin X-API-Key.

Cómo resolverlo

Verifica que envías la llave correcta para el entorno (skp_live_ vs skp_test_). Para operaciones que mueven dinero, usa el flujo firmado (nivel 2).

Ejemplo

{
  "type": "https://docs.skipo.com/errors/unauthorized",
  "title": "Unauthorized",
  "status": 401,
  "code": "unauthorized",
  "retryable": false,
  "detail": "Falta la credencial o no es válida."
}

---

Volver al catálogo de errores · Ver el formato de errores.