Límites
Todos los límites de tamaño y cantidad en un solo lugar — cuerpo de la solicitud, state y presupuesto de tokens, schema de decisión, destinos y entregas, identificadores, workspace, equipo e inicio de sesión.
Solicitudes a la API
| Límite | Valor | Al superarlo |
|---|---|---|
| Cuerpo de la solicitud | 128 KB | 413 PAYLOAD_TOO_LARGE — "Request body is too large." |
| Cuerpo de la solicitud que lleva un schema de decisión | 1 MB — POST /mcp (validate_schema, create_decision, update_decision) y el editor de la app. El state que contiene sigue limitado a 128 KB | 413 PAYLOAD_TOO_LARGE — "Request body is too large." |
| Cuerpo de la solicitud de una ejecución | 32 MB — POST /v1/decisions/{slug}, el Playground y POST /v1/hooks/{token} (JSON, texto o multipart/form-data), para que el state pueda llevar archivos | 413 PAYLOAD_TOO_LARGE — "Request body is too large." |
Archivos en un state (campos image, audio, file) | 20 MB cada uno, 24 MB y 10 archivos en total; su texto se recorta a unos 96,000 caracteres en total | 422 INVALID_STATE — "Field invoice is too large (…)" |
| State serializado (sin sus archivos) | 128 KB y unos 32,000 tokens (caracteres ÷ 4, es decir, unos 128,000 caracteres de JSON) | 422 INVALID_STATE — "Field state is too large (…)" |
| Presupuesto de tokens por llamada | unos 32,000 tokens para el state más la pregunta más larga, 64,000 para el state más todas las preguntas | 422 INVALID_STATE — "The state plus … is too large …" |
| Elementos en un state de lista | 1 a 500 | 422 INVALID_STATE — "Field state has too many items (…)" |
| Solicitudes por minuto | 60 / 300 / 2,000 / 10,000 según el plan, por workspace — las decisiones y las lecturas (GET /v1/decisions, /v1/me, /v1/executions) se cuentan por separado | 429 RATE_LIMITED — consulta Límites de tasa |
| Volumen incluido | 1M al mes en Genesis, más en los planes de pago; después, las decisiones se pagan con créditos prepagos, hasta el tope de gasto opcional por ciclo de facturación | 402 CREDITS_EXHAUSTED sin créditos, 402 SPEND_CAP_REACHED al llegar al tope de gasto — 402 QUOTA_EXCEEDED en un plan con tope fijo. Consulta Planes |
| Plazo del motor | el timeoutMs de la decisión: 5,000 ms por defecto, de 500 a 30,000, reintentos incluidos | 504 ENGINE_TIMEOUT |
Tamaño de página de GET /v1/executions | 1 a 100, por defecto 20 | 400 INVALID_REQUEST |
Idempotency-Key | 1–128 caracteres de A–Z a–z 0–9 . _ : - | 400 INVALID_REQUEST |
X-Request-ID | 1–128 caracteres del mismo conjunto | Se reemplaza por un ID req_… generado (sin error) |
| Reproducciones idempotentes | 24 horas | Se trata como una solicitud nueva |
Los tokens se estiman como caracteres ÷ 4 del JSON serializado. El presupuesto de tokens es el de Jev: las preguntas cuentan con sus instrucciones, opciones, niveles y criterios.
Schema de decisión
| Elemento | Límite |
|---|---|
| Preguntas por decisión | 1 a 64 |
| Reglas de política por decisión | hasta 50 |
| Condiciones AND adicionales por regla | hasta 5 |
| Compuestos por decisión | hasta 20 |
| Términos por compuesto | 1 a 20 |
| Peso de un término compuesto | −100 a 100, distinto de 0 |
| Campos del state (state de objeto) | hasta 50 |
| Elementos en un state de lista | 1 a 500 |
| Opciones por pregunta choice | 2 a 254, más other |
| Niveles por pregunta score | 2 a 10 |
| Instrucciones | 1 a 8,000 caracteres |
context | hasta 8,000 caracteres |
| Descripción de opción, nivel de score, criterio de probability | hasta 2,000 caracteres |
| Descripción de un campo del state | hasta 255 caracteres |
Valor string de una política, label de un nivel estructurado | hasta 255 caracteres |
| Descripción de un compuesto | hasta 500 caracteres |
| Claves (campos, preguntas, compuestos, valores de opción) | snake_case, hasta 48 caracteres |
minConfidence | 0 a 1 |
timeoutMs | 500 a 30,000 |
| Schema completo, serializado | hasta 1 MB (el cuerpo que lo lleva) |
Las instrucciones, las descripciones de opción, los niveles de score y los criterios pueden ser texto o JSON; el JSON se mide por su longitud serializada. Consulta Schema de decisión.
Decisiones
| Elemento | Límite |
|---|---|
| Nombre | 1 a 80 caracteres |
| Descripción | hasta 500 caracteres |
| Slug | hasta 64 caracteres: letras minúsculas, dígitos y guiones simples; se bloquea tras la primera publicación |
| Decisiones por workspace | Genesis 2, Developer 10, Growth y Enterprise ilimitadas (402 PLAN_LIMIT_REACHED) |
Workspace
| Elemento | Límite |
|---|---|
| API keys activas | 50 por workspace (409 CONFLICT — revoca primero una clave sin uso) |
| Nombre de una API key | 1 a 80 caracteres |
| Clave del proveedor (BYOK) | 8 a 512 caracteres |
| Retención del registro de ejecuciones | Genesis 7, Developer 14, Growth 30, Enterprise 365 días — o menos, según la configuración del workspace |
| Playground | 30 ejecuciones por minuto y 2,000 por día |
| Códigos de inicio de sesión | 6 dígitos, válidos 10 minutos, 5 intentos, 3 códigos por e-mail cada 10 minutos y 10 por día |
| Inicio de sesión con contraseña | 5 intentos fallidos por e-mail, luego una espera de 15 minutos |
| Contraseña | 10 a 128 caracteres, letras y números |
Equipo
| Elemento | Límite |
|---|---|
| Workspaces de tu propiedad | 10 (409 CONFLICT) |
| Invitaciones | válidas 7 días; 30 por hora por workspace y por persona (429 RATE_LIMITED) |
| Invitaciones pendientes | 50 por workspace (409 CONFLICT) |
Consulta Equipo, roles y cuenta.
Destinos
| Límite | Valor |
|---|---|
| Destinos por decisión | 20 |
| Destinos que se disparan por ejecución | 10 |
Respuestas LLM y agentes sync por ejecución | 3 |
| Condiciones por destino | 5 |
| Params por destino | 30 |
| Valor fijo de un param | hasta 500 caracteres |
| Headers por destino | 20 |
| Valor de un header | hasta 2,048 caracteres |
| URL | hasta 2,048 caracteres |
Plantilla del cuerpo http | hasta 10,000 caracteres |
| Descripción del destino | hasta 2,000 caracteres |
| Texto de la respuesta | hasta 4,000 caracteres |
| Botones de la respuesta | hasta 10, de hasta 80 caracteres cada uno |
Prompt e input del LLM, instructions e input de la salida estructurada | hasta 8,000 caracteres cada uno |
| Instrucciones del agente | hasta 32,000 caracteres |
| Herramientas del agente | hasta 50 |
Timeout del LLM y de agentes sync | 1,000 a 25,000 ms, por defecto 20,000 |
maxTokens del LLM | 16 a 2,048, por defecto 512 |
temperature del LLM | 0 a 2, por defecto 0.3 |
Respuesta del agente devuelta en response | hasta 16,000 caracteres |
| Intentos de entrega | 6, a lo largo de unas 7 horas |
| Timeout de un intento de entrega | 10 segundos |
| Entregas por workspace | 600 por minuto |
| Retención de entregas | 30 días |
| Secretos del workspace | 50, valores de hasta 4,096 caracteres |
Más allá de estos límites, un destino que coincide se omite con "reason": "limit", y un destino inválido hace que el schema sea inválido (422 INVALID_SCHEMA). Consulta Seguridad y límites de los destinos.
Idempotencia
Reintenta de forma segura con el header Idempotency-Key — claves reservadas antes de la ejecución, reproducción de llamadas exitosas durante 24 horas, el header Idempotent-Replayed e IDEMPOTENCY_CONFLICT.
Resumen de los SDKs
Los SDKs oficiales de TypeScript y Python — qué agregan frente a HTTPS directo, cómo se comparan y cómo compilarlos desde el código fuente hasta que se publiquen en npm y PyPI.