Recover from a failed request

Match Transform error codes to fixes for rejected input, expired results, and access failures. Check existing jobs before retrying a request.

Error responses contain code and message. This example shows a missing-document error:

{"code":"missing_input","message":"input is required: attach the document as the 'input' file field."}

Correct the request

Code or response	Action
missing_input, invalid_input	Supply one supported document source and check the request encoding.
malformed_schema_json, invalid_schema	Correct JSON syntax and schema constraints.
schema_too_large, file_too_large	Reduce the input to the documented limit.
unsupported_file_type	Use a supported extension and actual file format.
invalid_output_format, output_option_unavailable	Use a supported output representation and compatible include options.
unauthorized / HTTP 401	Supply a valid API key for the target environment.
forbidden / HTTP 403	Confirm that the key is authorized for the target environment and resource. If access is still denied with an authorized key, contact support. Do not retry the unchanged request.
not_found / HTTP 404	Check the ID, credential, and expiry; re-upload if needed.
parse_not_complete	Wait for a successful Parse before extracting; inspect failed jobs.
parse_expired	Parse the original document again.
result_expired / HTTP 410	The job metadata remains available, but its stored result is no longer available. Re-run the original request.
rate_limited	Reduce request frequency and retry with backoff. If the response includes Retry-After, wait that long.
quota_exceeded	Check your account’s available quota before retrying.
profile_unavailable	Omit the optional profile or use a profile listed in the Parse reference.
could_not_parse, parse_job_failed	Verify that the file opens, matches a supported file type, is within the size limit, and has readable text or scanned pages. Read the returned message, correct the file or request, then retry.
job_not_terminal	Wait for a terminal status before deleting a job.
method_not_allowed	Check the HTTP method in the endpoint reference.
internal_error / HTTP 500	Upload can return this response without creating a job. Retry the original upload after checking the file and request. If failures continue, contact support with the operation, HTTP status, and public error code.
HTTP 502	Parse and job operations can return this response. If you have a job ID from the request, check that job before resubmitting. Otherwise, retry after checking the request. If failures continue, contact support with the operation, HTTP status, public error code, and any job ID.

Coverage of HTTP statuses and error codes varies by endpoint. The API reference defines each operation’s responses.

Check a response that looks successful

Before using an HTTP 200 response, check status, warnings, and the expected content field: markdown, elements, or extracted_data. If the expected field is empty or unusable, keep the response and job ID, compare the output with the source document, and follow the support request guidance if the problem continues. An empty result is not confirmation that the document was processed correctly.

If an SSE stream disconnects

A dropped server-sent-events connection leaves the job outcome unknown. Use the same job ID or retrieval path to request the current status and result. If the job is still queued or processing, continue following it through request progress. Do not resubmit until you know the original job has reached a final status.

Report a persistent problem

Provide the operation, HTTP status, public error code, and job ID when you open a support request. Do not send your API key or confidential document contents.