Skip to content
⌘K
InboxAsk a human

API Limitations

Updated by Danish

In this article

In this article group

To ensure optimal performance, fair usage, and compliance with accreditation requirements, Woolf’s Airlock API includes several limitations. Understanding these limits will help you integrate and operate smoothly.

📈 Request Rate Limit

To prevent abuse and ensure system reliability, API usage is subject to a rate limit.

  • Limit: 50 requests per minute per client.

  • Exceeding this limit will return a 429 Too Many Requests response.

  • To avoid being throttled, implement rate-limiting or request queuing in your system.

🧠 GraphQL Query Depth Limit

To protect against overly complex or nested queries, the GraphQL API enforces a query depth limit.

  • Maximum Depth: 5 levels of nesting

  • Queries exceeding this will return a 413 Payload Too Large error.

  • Design your queries efficiently to stay within depth limits and reduce load.

📂 File Upload Size Limit

The API supports file uploads for assets like documents, videos, and images.

  • Max File Size: 1 GB

  • Uploads beyond this will return a 413 Payload Too Large error.

  • Large videos should be compressed or streamed using HTTP Live Streaming (HLS).

Explore More