Skip to main content
POST
/
v1
/
workflows
/
experiments
/
runs
/
{run_id}
/
cancel
from retab import Retab

client = Retab()

run = client.workflows.experiments.runs.cancel("exprun_2")
print(run.lifecycle.status)

{
  "id": "exprun_2",
  "lifecycle": { "status": "cancelled" },
  "timing": {
    "created_at": "2026-05-18T10:00:00Z",
    "started_at": "2026-05-18T10:00:01Z",
    "completed_at": "2026-05-18T10:00:04Z"
  }
}
Cancel one pending or running experiment run by run_id. Cancellation is run-specific; it no longer targets “the latest run” for an experiment. 
from retab import Retab

client = Retab()

run = client.workflows.experiments.runs.cancel("exprun_2")
print(run.lifecycle.status)

{
  "id": "exprun_2",
  "lifecycle": { "status": "cancelled" },
  "timing": {
    "created_at": "2026-05-18T10:00:00Z",
    "started_at": "2026-05-18T10:00:01Z",
    "completed_at": "2026-05-18T10:00:04Z"
  }
}

Authorizations

​
Api-Key
string
header
required

Path Parameters

​
run_id
string
required

Response

Successful Response

Result of cancelling an experiment run: the run id and its resulting lifecycle state.

​
id
string
required
​
lifecycle
PendingWorkflowExperimentRun · object
required

The experiment run has been created but execution has not started.