Limits

Flux API has various limits to ensure optimal performance and prevent abuse. Understanding these limits helps you design efficient applications and handle edge cases appropriately.

Request Limits

Limit	Value	Description
Results per request	50	Maximum number of resources returned in a single request
Request timeout	60 seconds	Maximum time allowed for request processing
Response size	5 MB	Maximum size of API response payload
Authentication timeout	10 minutes	Maximum time difference allowed for secure authentication timestamps

Search & Query Limits

Limit	Value	Description
Join folders	3	Maximum number of folders that can be joined in a single query
Population depth	3 levels	Maximum nesting depth for resource population (e.g., `author.company.address`)
Full text search query length	1,000 characters	Maximum length for `find_text` and `find_phrase` queries
Typo tolerance	0-2	Range of allowed typos in full-text search

Pagination Limits

Limit	Value	Description
Maximum results per page	50	Maximum number of results per page

URL & Browser Limits

Limit	Value	Description
URL length	~2,048 characters	Typical browser URL length limit (affects List Resources with complex queries)

Error Responses for Limit Violations

When limits are exceeded, Flux API returns specific error codes:

Request Timeout (408)

{
  "message": "Request timeout",
  "error_code": "request_timeout",
  "detail": null
}

Response Size Exceeded (413)

{
  "message": "Response size exceeded",
  "error_code": "max_response_size_exceeded",
  "detail": null
}

Too Many Join Folders (422)

{
  "message": "Too many folders in join",
  "error_code": "too_many_join_folders",
  "detail": null
}

Rate Limit Exceeded (429)

{
  "message": "Rate limit exceeded",
  "error_code": "rate_limit_exceeded",
  "detail": null
}