Sign in

v1

latestOpenAPI 3.1.02026-07-24251250397.8 KB
transformations

Retry a transformation run step

Retries a step by creating a new execution and resuming the run from that point

The retry applies to the step's latest attempt: if the step has already been retried, the request is forwarded to the most recent attempt in its retry chain.

  • If the latest attempt is terminal (succeeded, failed, or skipped), a new execution is created that reuses that attempt's inputs and the run resumes.
  • If the latest attempt is still in progress, that attempt is returned and no new execution is created, so the request is safe to repeat.

Only terminal steps can be retried: a 400 error is returned when the step has no newer attempt and is not yet terminal.

put/v2/sites/{site_id}/transformation_run_steps/{transformation_run_step_id}/retry/

Path parameters

site_idstring required

Unique identifier for a resource

Example:Ny05CEfj

Unique alphanumeric ID of the site

transformation_run_step_idstring required

Unique identifier for a resource

Example:Ny05CEfj

Unique alphanumeric ID of a single step within a transformation run

Response

Step retry processed successfully

idstring

Unique identifier for a resource

site_idstring

Unique identifier for a resource

type'transformation_run_step'

Resource type identifier

transformation_run_idstring

Unique identifier for a resource

step_typestring

Type of work performed by this step, such as script generation, audio generation, or review

started_atstring date-time nullable

Timestamp when the step started processing

Example response

{
  "id": "Ny05CEfj",
  "site_id": "Ny05CEfj",
  "transformation_run_id": "Ny05CEfj",
  "lineage": {
    "parent_step_ids": [
      "Ny05CEfj"
    ],
    "retried_from_step_id": "Ny05CEfj"
  },
  "metadata": {
    "output_data": {
      "asset_version_ids": [
        "Ny05CEfj"
      ],
      "decision": {
        "decided_by": "Ny05CEfj",
        "approved_asset_version_ids": [
          "Ny05CEfj"
        ],
        "regenerate_input_asset_version_ids": [
          "Ny05CEfj"
        ]
      }
    }
  },
  "relationships": {
    "transformation_run": {
      "id": "Ny05CEfj"
    }
  }
}