> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orbit.devotel.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Solución de problemas: autenticación y claves de API

> Identifica el control que rechazó una respuesta 401, 403 o 422 y corrige la clave, el modo o la lista de IP.

# Solución de problemas: autenticación y claves de API

Cada solicitud a Orbit pasa por controles de credenciales, caducidad y revocación, modo sandbox/live, lista de IP y permisos. Lee `code`: varios controles pueden compartir el mismo estado HTTP.

| Código | HTTP | Control |
| - | - | - |
| `UNAUTHORIZED` | 401 | No hay credencial utilizable |
| `INVALID_API_KEY` | 401 | Clave desconocida, revocada o enviada desde una IP no permitida |
| `EXPIRED_TOKEN` | 401 | La clave caducó o llegó su revocación programada |
| `WRONG_KEY_MODE` | 403 | El modo de la clave no coincide con el workspace |
| `IP_NOT_ALLOWED` | 403 | La lista de IP de la organización bloqueó el origen |
| `INSUFFICIENT_PERMISSIONS` | 403 | El rol o alcance no permite la ruta |
| Escritura con clave pública | 422 | La clave `dv_..._pk_` solo permite lecturas |
| `STALE_WEBHOOK` | 401 | Falta o caducó la marca de tiempo del webhook |

## Errores 401

Para `UNAUTHORIZED`, confirma el encabezado `X-API-Key` y envía la clave completa. `INVALID_API_KEY` indica una clave desconocida, revocada o bloqueada por una lista de IP de la clave. Cópiala de nuevo en **Settings → API Keys** o crea un reemplazo. `EXPIRED_TOKEN` indica que venció la fecha o `revoke_at`; rota la clave.

## Sandbox y live

Una clave `dv_test_sk_` debe usarse en sandbox y una `dv_live_sk_` en live. La combinación incorrecta devuelve `403 WRONG_KEY_MODE` antes del handler. Crea la clave en la organización que estás llamando.

## Listas de IP

Una IP bloqueada por la clave aparece deliberadamente como `401 INVALID_API_KEY`. La lista de la organización devuelve `403 IP_NOT_ALLOWED`. Comprueba la IP pública de salida que ve Orbit y añade esa IP o su rango CIDR en la configuración de seguridad.

## Claves públicas y SAML/SCIM

Las claves públicas son de solo lectura. Usa una clave secreta en tu backend para escrituras como `messages:write`. En SAML, el usuario debe pertenecer a la organización; SCIM no puede superar el límite de roles configurado.

Nunca envíes el secreto a soporte. Incluye el código, `request_id` y solo el prefijo de la clave.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.