Rate limits

La cuota de la API pública se aplica por organización, no por credencial individual.

Límite	Valor
Cuota principal	`5000` requests por hora por organización
Burst protection	`120` requests por minuto por organización
Superficie afectada	API pública autenticada (`/api/v1/*`)
Fuera de alcance	`/health`, `OPTIONS`, rutas internas y webhooks

Todas las API keys y todos los access tokens OAuth delegados de la misma organización comparten la misma cuota.

Headers

Las responses incluyen headers de rate limit. Cuando recibís 429, también recibís Retry-After.

HTTP/1.1 429 Too Many Requests
Retry-After: 30
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 30
RateLimit-Limit: 5000
RateLimit-Remaining: 0
RateLimit-Reset: 30

Respuesta 429

{
  "request_id": "req_rate_limit_1",
  "error": {
    "type": "rate_limit_error",
    "code": "RATE_LIMITED",
    "message": "Se alcanzó el límite de solicitudes de la organización. Reintentá más tarde.",
    "retryable": true,
    "details": []
  }
}

Qué hacer

Leé el header Retry-After.
Esperá esa cantidad de segundos.
Reintentá la misma operación después de la ventana de espera.

Si tu integración maneja retries automáticos, usá Retry-After como fuente de verdad para el backoff.

Documentación

SDK

Referencia API

Headers

Respuesta 429

Qué hacer

​Headers

​Respuesta 429

​Qué hacer

Headers

Respuesta 429

Qué hacer