Falta la llave de API o no es válida

401unauthorized

Qué significa

La petición no trae una llave de API que Emitay reconozca. No se hizo nada y no cuenta para el límite de peticiones.

No reintentes la misma petición: fallará igual hasta que cambie lo que se indica abajo.

Por qué ocurre

• Falta la cabecera Authorization: Bearer sk_….
• La llave está mal copiada, le sobra un espacio o un salto de línea, o le falta el prefijo Bearer.
• La llave fue revocada en el panel: deja de servir en ese instante.
• La variable de entorno que guarda la llave (EMITAY_API_KEY) está vacía en ese proceso.

Cómo resolverlo

1. Comprueba la llave con npx emitay whoami: responde con la empresa y el modo, o con este mismo error.
2. Si la perdiste, crea otra en el panel (Llaves de API): una llave solo se muestra al crearla.
3. Revisa que el proceso que llama reciba la variable: en producción suele faltar en el servicio, no en tu terminal.

Cómo llega

La respuesta es application/problem+json con estado 401, y su campo type es la dirección de esta página.Lo de abajo es lo que respondió la API a una petición que provoca este error.

{
  "type": "https://docs.emitay.com/errors/unauthorized",
  "title": "Falta la llave de API o no es válida",
  "status": 401,
  "detail": "Envía tu llave en la cabecera Authorization: Bearer sk_…, o usa la sesión del panel con Emitay-Company y Emitay-Livemode"
}

Toda respuesta lleva además la cabecera Request-Id (req_…): cítala al pedir soporte.

Sigue con: Autenticación y modos · todos los errores