Get started

Convert a file in two API operations

Use the API key shown after AWS Marketplace registration. Keep it server-side and never place it in browser code or a public repository.

1. Submit the file

curl --request POST 'https://api.corenovacloud.com/v1/conversions' \
  --header 'Authorization: Bearer API_KEY' \
  --header 'Idempotency-Key: migration-batch-42-file-1' \
  --form 'file=@example.doc'

The API responds immediately after securely storing and queuing the file:

{
  "task_id": "7bf1fb66240f4a99ad7786b0ed8b2a34",
  "status": "QUEUED",
  "status_url": "https://api.corenovacloud.com/v1/conversions/7bf1fb66240f4a99ad7786b0ed8b2a34",
  "idempotent_replay": false
}

2. Query the task

curl --header 'Authorization: Bearer API_KEY' \
  'https://api.corenovacloud.com/v1/conversions/7bf1fb66240f4a99ad7786b0ed8b2a34'

When conversion succeeds, download the result before the URL expires:

{
  "task_id": "7bf1fb66240f4a99ad7786b0ed8b2a34",
  "status": "SUCCEEDED",
  "source_filename": "example.doc",
  "dimension": "DocConversion",
  "result_size": 17030,
  "download_url": "https://temporary-s3-url.example/…",
  "download_expires_in": 300
}