Skip to content
Emitia

Error: invalid_api_key

Qué significa

Section titled “Qué significa”

La clave API proporcionada en el header Authorization no es válida, no existe en la base de datos de Emitia, o fue revocada.

Envelope de ejemplo

Section titled “Envelope de ejemplo”
{
  "error": {
    "type": "authentication_error",
    "code": "invalid_api_key",
    "message": "La clave API proporcionada no es válida o fue revocada.",
    "doc_url": "https://docs.emitia.co/errors/invalid_api_key",
    "request_id": "req_01HX…"
  }
}

HTTP status: 401 Unauthorized

Causas frecuentes

Section titled “Causas frecuentes”
CausaSíntoma
La clave fue copiada con espacios extraEl string tiene 1-2 caracteres extra
La clave fue revocada en el dashboardFuncionaba antes, ahora falla
Estás usando sk_test_ contra un recurso de producciónSolo aplica a resources reales
El header Authorization falta o tiene formato incorrectoFormato esperado: Bearer sk_test_…
Rotación de clave no propagadaEl código antiguo sigue con la clave vieja

Cómo resolverlo

Section titled “Cómo resolverlo”

  1. Verifica que el header tiene el formato correcto:

    Authorization: Bearer sk_test_TU_CLAVE_SIN_ESPACIOS

  2. Prueba con GET /v1/account para aislar el problema:

    Terminal window
    curl https://api.emitia.co/v1/account \
      -H "Authorization: Bearer sk_test_TU_CLAVE"

  3. Si falla, ve al dashboard → API Keys → verifica que la clave esté activa.

  4. Si necesitas una clave nueva, créala en el dashboard. Las claves se muestran una sola vez al crearlas.

Ver también

Section titled “Ver también”