API response codes
reading time 3 minutes
Error response bodies
Use the HTTP status first, then inspect the response body. Error shapes vary across the Go and Python services.
Go errors commonly look like:
{"code":"not_found","message":"Resource not found"}Field validation may instead return an array:
[{"field":"page_size","error":"is required"}]Python errors can be an array of objects containing id, title, code_name, detail, and meta. Do not assume every error is a single object with an error property.
The upload handler enforces a concurrency limit, and account usage limits also apply. This edition does not promise the old documentation's universal 300-requests-per-minute allowance or its conflicting claim of no limits. Confirm deployment-specific limits with your administrator.
Generation and invocation can create duplicate work if repeated after a timeout. There is no documented idempotency-key contract for these endpoints. Preserve returned IDs and reconcile the outcome before retrying a create request. Batch deletions can partially succeed before reporting a failure.
Questions?
Contact [email protected] for help diagnosing repeated API failures.
Updated 19 days ago