Translation APIReference
v2.0.0

Translation API · Concept

File Uploads

Upload private source files and use their public IDs in projects or quotes.

Upload each source with multipart POST /files before creating a file-based project or quote.

Upload a Source

curl https://apis.stepes.com/v2/files \
  --request POST \
  --header "Authorization: Bearer ${STEPES_API_KEY}" \
  --header 'Idempotency-Key: erp-order-1002-source-v1' \
  --form 'file=@/absolute/path/source.docx'

The response returns a file_... ID. Use that ID in file_ids when creating a project or quote.

Analysis State

Use GET /files/{fileId} when the upload is not immediately ready. A file is either:

  • ready: the file can be attached to a project or quote;
  • manual_review: the file needs additional analysis before it can be used.

If a file remains in manual_review, check it again later or contact Stepes support.

Create Work

Pass up to the capability-advertised maximum number of file IDs in file_ids. Each file must have been uploaded with the same API environment and remain available for use.

Download or Delete

An owned source can be downloaded through /files/{fileId}/download. An unattached draft input can be deleted idempotently. Attached or otherwise protected source records cannot be removed through the public API.

Related Reference