Translation APIReference
v2.0.0

Files

Upload a source file

Upload one source file and receive a file ID that can be used to create a project or quote.

POST/files

API key permission: files:write. Send a unique Idempotency-Key and reuse it only when retrying the same request.

Parameters

NameTypeDescription
Idempotency-Keystring · required

Unique operation key. Reuse it only with the same method, path, and request body.

Request body

multipart/form-data
filestringRequired

One private source file within the current max_file_bytes capability limit.

Standard response headers

HeaderExampleDescription
Stepes-Request-Idb09de4aa-3874-4991-b85c-0bc86e780511

Server-generated request identifier for support and audit correlation.

Stepes-API-Version2.0.0

Effective Stepes API semantic version.

RateLimit-Policy120;w=60

Effective request limit and window for the authenticated key.

RateLimitlimit=120, remaining=119, reset=60

Current limit, remaining requests, and reset interval.

Idempotency-Replayedtrue

Present with value true when a stored mutation response is replayed.

Responses

201

File created

401

Missing, malformed, expired, revoked, or disallowed API key

409

Idempotency conflict or invalid lifecycle transition

422

Request validation failed

{
  "id": "string",
  "object": "file",
  "filename": "string",
  "mime_type": "string",
  "size": 1,
  "checksum_sha256": "string",
  "status": "ready",
  "analysis": {},
  "created_at": "2026-07-23T12:00:00Z"
}