Translation APIReference
v2.0.0

Quotes

Recalculate an editable quote with revised inputs

Update an editable quote and recalculate its price before submission or acceptance.

PATCH/quotes/{quoteId}

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

Parameters

NameTypeDescription
quoteIdstring · required

path parameter

Idempotency-Keystring · required

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

Request body

application/json
namestringOptional

See schema for validation constraints.

external_idstring | nullOptional

See schema for validation constraints.

source_languagestringOptional

See schema for validation constraints.

target_languagesstring[]Optional

See schema for validation constraints.

servicestringOptional

See schema for validation constraints.

turnaroundstringOptional

See schema for validation constraints.

due_atstring | nullOptional

See schema for validation constraints.

instructionsstring | nullOptional

See schema for validation constraints.

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

200

Revised quote

404

Resource was not found or is not available to this API key

409

Idempotency conflict or invalid lifecycle transition

422

Request validation failed

{
  "id": "quote_01JZ8K6N2W6RX4J9P7Y8K3M2Q3",
  "object": "quote",
  "external_id": "SKU-1042-ES",
  "status": "draft",
  "name": "Catalog SKU 1042",
  "source_language": "EN-US",
  "target_languages": [
    "ES-ES"
  ],
  "source_files": [
    {
      "id": "file_01JZ8K6N2W6RX4J9P7Y8K3M2Q2",
      "object": "file",
      "filename": "catalog-sku-1042.json",
      "mime_type": "application/json",
      "size": 142,
      "status": "ready",
      "download_url": "https://apis.stepes.com/v2/files/file_01JZ8K6N2W6RX4J9P7Y8K3M2Q2/download",
      "content_url": "https://apis.stepes.com/v2/files/file_01JZ8K6N2W6RX4J9P7Y8K3M2Q2/content"
    }
  ],
  "currency": "USD",
  "subtotal": 25,
  "total": 25,
  "expires_at": "2026-09-09T12:00:00+00:00",
  "project_id": null,
  "created_at": "2026-08-10T12:00:00+00:00",
  "updated_at": "2026-08-10T12:00:00+00:00"
}