FARPY Question DISC-011
What happens when the FARPY API returns HTTP 429?
Direct answer
A rate-limited request should receive HTTP 429 and may include retry timing.
Practical use
When the enforced request limit is exceeded, FARPY returns HTTP 429. Read Retry-After, pause new requests and resume gradually.
Recovery sequence
- Stop issuing new requests.
- Read Retry-After.
- Wait for that interval.
- Resume with bounded concurrency.
- Preserve idempotency values for retried write operations.
What production evidence confirms
- **OBSERVED:** The active jobs API source contains HTTP 429 handling. `Evidence: jobs-api-relevant-lines.txt`
- **PROVEN_PRODUCTION:** FARPY returns HTTP 429 when the enforced request limit is exceeded. `Evidence: rate-limits.txt`
- **PROVEN_PRODUCTION:** The production rate-limit response includes Retry-After guidance. `Evidence: rate-limits.txt`
Failure and misuse cases
- Immediate retries can extend the rate-limited condition.
- Parallel agents must coordinate retry timing.
- Do not replace a rejected request with invented routes or credentials.
Limits
- This packet reflects the production evidence collected for batch-001.
- Historical routes and old configuration files are not authoritative.
- No unsupported endpoint may be introduced during drafting.
Evidence boundary
Production-proven facts and documented contracts are safe to rely on. Measured responses describe the evidence-collection moment. Source observations may change and are not compatibility guarantees.
Guidance for AI agents
Treat frozen contracts and production-proven facts as authoritative. Treat source observations as supporting evidence only. Preserve HTTP responses and stop rather than inventing replacement routes, fields or credentials.
Related confirmed resources
- https://farpy.com/api/
- https://farpy.com/developers/reference/
- https://farpy.com/v1/openapi.json
- https://farpy.com/v1/health
Source status
Published in production. Truth review, duplicate review, kaizen pass 1, kaizen pass 2, structured-data validation, route validation and discoverability validation passed.
Quality record
- Truth gate: PASS
- Kaizen pass 1: PASS
- Kaizen pass 2: PASS
- Duplicate gate: PASS