API request limits
Learn about the limits for HTTP POST requests in Reltio APIs.
Reltio enforces a platform-level size limit on the body of HTTP POST requests to ensure consistent API performance across all environments. This limit is applied at the infrastructure level and does not vary by tenant or subscription type.
Maximum POST request size
The maximum allowed size for any HTTP POST request body is 50 MB.
If your request exceeds this size, the platform responds with:
HTTP/1.1 413 Payload Too LargeThis response indicates that the payload must be reduced before it can be processed.
When this limit applies
This limit affects all Reltio API endpoints that accept request bodies, including:
- Entity ingestion APIs
- Relationship creation APIs
- Batch operations across Data APIs
- Any synchronous or asynchronous POST endpoints
Recommendations and mitigation strategies
To avoid request failures and ensure optimal API performance:
- Split payloads into batches between 10 MB and 20 MB for best performance, and never exceed the 50 MB platform limit
- Use streaming or chunked ingestion tools such as Data Loader or Integration Hub
- Monitor and retry requests that return
413errors with reduced payload size