POST

Retry Execution

Re-runs a failed execution from the failing step.

POSThttps://api.vantaxai.com/v1/executions/{execution_id}/retry

Replays the execution using the original `trigger_event`. Steps that already completed are skipped, and execution resumes from the first failed step. Returns a new execution in the `running` state.

Only failed runs

Retry is available for executions with status `failed`. Retrying a completed or running execution returns a 409 Conflict.

Headers

Authorizationstringrequired
Bearer authentication with your secret API key.
example: Bearer vx_live_3fa9c2…

Path Parameters

execution_idstringrequired
The execution to retry. Must be in the `failed` state.
example: exec_5a90fd

Request

curl -X POST https://api.vantaxai.com/v1/executions/exec_5a90fd/retry \
  -H "Authorization: Bearer vx_live_3fa9c2..."

const res = await fetch(
  "https://api.vantaxai.com/v1/executions/exec_5a90fd/retry",
  {
  method: "POST",
  headers: {
    Authorization: "Bearer vx_live_3fa9c2...",
  },
  }
);
const { data } = await res.json();

import { Vantax } from "@vantax/sdk";

const vantax = new Vantax({ apiKey: process.env.VANTAX_API_KEY! });
// POST /v1/executions/{execution_id}/retry
const result = await vantax.request("POST", "/v1/executions/{execution_id}/retry");

from vantax import Vantax

vantax = Vantax(api_key=os.environ["VANTAX_API_KEY"])
# POST /v1/executions/{execution_id}/retry
result = vantax.request("POST", "/v1/executions/{execution_id}/retry")

Response

{
  "success": true,
  "message": "Execution retry started",
  "data": {
    "id": "exec_c10f8a",
    "workflow_id": "wf_4c81a0",
    "status": "running",
    "retry_of": "exec_5a90fd",
    "trigger_event": {
      "type": "contact.created",
      "contact_id": "ct_44be01",
      "source": "website"
    },
    "started_at": "2026-02-03T09:00:00Z",
    "finished_at": null
  }
}

{
  "success": false,
  "message": "Only failed executions can be retried"
}