API Limitations

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