Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.seal.run/llms.txt

Use this file to discover all available pages before exploring further.

The Seal API enables programmatic access to your data and platform functionality. Rate limits are applied to ensure fair usage.

Authentication

API requests require a bearer token. Organization Admins can generate, revoke, and rename API keys from Settings → API Keys.
Authorization: Bearer <your-api-key>

Rate limits

Each API key is subject to two independent limits, both intentionally generous — well-behaved integrations rarely encounter either:
  • Request rate — approximately 2,000 requests per minute (per API key, per server instance).
  • Concurrent in-flight requests — approximately 100 at a time (per API key).

Request-rate headers

Every response carries the current request-rate state in a rolling one-minute window:
HeaderMeaning
X-RateLimit-LimitRequests allowed in the current window
X-RateLimit-RemainingRequests remaining in the current window
X-RateLimit-ResetUnix timestamp (seconds) when the window resets
When you exceed the request-rate limit the API returns HTTP 429 with a Retry-After header (seconds). Back off for at least that many seconds; we recommend exponential backoff with jitter if you hit the limit repeatedly.

Concurrent-request 429s

Exceeding the concurrency limit also returns HTTP 429, but its headers look different because concurrency has no fixed reset window — a slot frees as soon as any of your in-flight requests completes:
HeaderMeaning on a concurrency 429
X-RateLimit-LimitConcurrent-request cap (e.g. 100)
X-RateLimit-RemainingAlways 0 on this response
Retry-AfterSeconds to wait (always 1)
X-RateLimit-Reset is not set on a concurrency 429. If you need to distinguish the two 429 classes programmatically, inspect the response body — the message field names the specific limit that fired (Rate limit exceeded: … for request-rate, Too many concurrent requests … for concurrency). If your integration legitimately needs a higher limit, contact support@seal.run.

API reference

Full API documentation: https://backend.seal.run/api/docs
Enterprise customers may have a dedicated API URL. Contact support@seal.run for your unique endpoint.