Error codes and retry guidance

HTTP errors include a stable machine-readable code and a link back to this page. A task that fails asynchronously returns the error inside its task response.

{
  "error": {
    "code": "unsupported_file",
    "message": "Use a .doc, .ppt, or .xls file.",
    "docs_url": "https://docs.corenovacloud.com/legacy-office-upgrade-api/errors/#unsupported-file"
  }
}

Code	Meaning	Retry
`missing_api_key`	Bearer credential was not provided.	Fix request
`invalid_api_key`	Credential is unknown or rotated.	Register again
`subscription_pending_or_inactive`	The Marketplace license is not active.	After activation
`unsupported_media_type`	Request is not multipart form data.	Fix request
`invalid_multipart`	Multipart body or boundary is invalid.	Fix request
`invalid_file_field`	Exactly one field named `file` is required.	Fix request
`invalid_filename`	Filename is empty, too long, or contains a path.	Fix request
`empty_file`	The uploaded file has no content.	Fix request
`file_too_large`	The file exceeds 4 MiB.	Use a smaller file
`unsupported_file`	Extension is not DOC, PPT, or XLS.	Fix request
`invalid_idempotency_key`	Idempotency key format is invalid.	Fix request
`idempotency_conflict`	The same key was reused for different content.	Use a new key
`job_not_found`	Task does not exist or belongs to another credential.	No
`not_ole_cfb`	The file is not a valid legacy Office OLE/CFB container.	No
`external_workbook_reference`	XLS references another workbook.	No
`database_formula`	XLS contains a database formula that cannot be preserved reliably.	No
`submission_unavailable`	The task could not be stored or queued.	Yes, safely
`conversion_failed`	An unexpected conversion error occurred.	Contact support