DOC, PPT, and XLS conversion API reference

Base URL: https://api.corenovacloud.com. All business endpoints require a CoreNova bearer credential created after AWS Marketplace registration.

POST/v1/conversions

Submit exactly one multipart/form-data field named file. The filename extension must be .doc, .ppt, or .xls.

Header	Required	Description
`Authorization`	Yes	`Bearer API_KEY`
`Idempotency-Key`	No	8–128 allowed characters; reuse only with the identical file.

Success: 202 Accepted. Size errors: 413. Authentication errors: 401 or 403.

GET/v1/conversions/{task_id}

Return the current task state. A successful task includes a five-minute presigned download URL while the result remains within its 30-minute retention window.

Task states

QUEUED — accepted and waiting for a worker.
PROCESSING — conversion is running.
SUCCEEDED — validated output is ready and counted once; billing_class is INCLUDED or OVERAGE.
FAILED — conversion was rejected or failed and does not consume allowance.
EXPIRED — the result retention window has ended.

GET/v1/account/usage

Return the active Marketplace plan and current contract-period allowance: included_quota, included_used, remaining, overage_used, and period_ends_at. This endpoint does not consume allowance.

Download the complete OpenAPI 3.0 definition.