Errors

Stable error codes and the correct response for each condition.

Every error uses the standard envelope. The code is stable for programmatic handling; the message is explanatory copy.

Status	Code	Meaning	Action
400	`INVALID_FILE_ID` / `INVALID_ORDER_ID` / `INVALID_ORDER_NUMBER` / `INVALID_CURSOR`	The path identifier or cursor is malformed.	Correct the request.
401	`API_KEY_INVALID` / `API_KEY_EXPIRED`	The key is missing, invalid, revoked, or expired.	Create or rotate a key.
403	`API_KEY_SCOPE_REQUIRED`	The key does not have `production_files:read`.	Use a key with the required scope.
404	`PRODUCTION_FILE_NOT_FOUND` / `PRODUCTION_FILES_NOT_FOUND`	The file or order is not available in the key's store.	Check the identifier and store.
409	`PRODUCTION_FILE_NOT_READY` / `PRODUCTION_FILES_NOT_READY` / `PRODUCTION_FILES_AMBIGUOUS` / `PRODUCTION_FILES_CHANGED`	The requested production state cannot be served yet or changed during preparation.	Refresh state and retry when appropriate.
410	`PRODUCTION_FILE_EXPIRED` / `PRODUCTION_FILES_EXPIRED`	The production file has passed its availability window.	Do not retry; use your retained fulfillment record.
503	`PRODUCTION_FILE_UNAVAILABLE` / `PRODUCTION_FILES_UNAVAILABLE`	The final object could not be verified temporarily.	Retry the read with backoff.