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 minuteper client.Exceeding this limit will return a
429 Too Many Requestsresponse.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:
5levels of nestingQueries exceeding this will return a
413 Payload Too Largeerror.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 GBUploads beyond this will return a
413 Payload Too Largeerror.Large videos should be compressed or streamed using HTTP Live Streaming (HLS).