Translation APIReference
v2.0.0

Projects · Event

project.updated

Schema 1.0

Project status, progress, or delivery availability changed.

Schema/developers/translation-api/reference/specs/stepes-translation-events-v2.json#/components/messages/ProjectUpdated

Webhook delivery is at least once. Deduplicate on the stable event id. The event is persisted before asynchronous delivery.

When this event is sent

The project's status, progress, or available results changed.

Required webhook headers

HeaderExamplePurpose
Content-Typeapplication/json

Stepes lifecycle event envelope.

Stepes-Webhook-Idevt_01JZ…

Stable event ID across delivery attempts.

Stepes-Webhook-Delivery-Idwhd_01JZ…

Endpoint-specific delivery record.

Stepes-Webhook-Timestamp1785001200

Signature input and replay protection.

Stepes-Webhook-Signaturev1=<digest>

HMAC-SHA-256 signature.

Payload fields

idstringRequired

Stable event ID used for consumer deduplication.

object"event"Required

Typed event payload field.

type"project.updated"Required

Typed event payload field.

created_atstringRequired

Typed event payload field.

dataobjectRequired

Typed event payload field.

{
  "id": "evt_01JZ8K6N2W6RX4J9P7Y8K3M2Q1",
  "object": "event",
  "type": "project.updated",
  "created_at": "2026-08-10T12:00:00Z",
  "data": {
    "object": {
      "id": "proj_...",
      "object": "project"
    }
  }
}

Signature verification

Compute HMAC-SHA-256 over <timestamp>.<raw_request_body>, compare in constant time, and reject stale timestamps.

Ordering and retries

Expect duplicates, delays, and occasional out-of-order events. The event ID remains stable across retries.