Execution

Operations about executions

Retrieve all executions

get

Retrieve all executions from your instance.

Authorizations

X-N8N-API-KEYstringRequired

Query parameters

includeDatabooleanOptional

Whether or not to include the execution's detailed data.

ignoreDataSizeLimitbooleanOptional

Whether to return the full execution data even if it exceeds the configured size limit (EXECUTIONS_DATA_MAX_DISPLAY_SIZE). Oversized executions are otherwise returned without their data.

redactExecutionDatabooleanOptional

Controls execution data redaction. When true, execution output data is always redacted. When false, requests unredacted (revealed) data — requires the execution:reveal scope. When omitted, follows the workflow redaction policy.

statusstring · enumOptional

Status to filter the executions by.

Possible values:

workflowIdstringOptional

Workflow to filter the executions by.

Example: 1000

projectIdstringOptionalExample: VmwOO9HeTEj20kxM

limitnumber · max: 250Optional

The maximum number of items to return.

Default: 100Example: 100

cursorstringOptional

Paginate by setting the cursor parameter to the nextCursor attribute returned by the previous request's response. Default value fetches the first "page" of the collection. See pagination for more detail.

Responses

200

Operation successful.

application/json

nextCursorstring · nullableOptional

Paginate through executions by setting the cursor parameter to a nextCursor attribute returned by a previous request. Default value fetches the first "page" of the collection.

Example: MTIzZTQ1NjctZTg5Yi0xMmQzLWE0NTYtNDI2NjE0MTc0MDA

401

Unauthorized

403

Forbidden

404

The specified resource was not found.

get/executions

GET /api/v1/executions HTTP/1.1
X-N8N-API-KEY: YOUR_API_KEY
Accept: */*

{
  "data": [
    {
      "id": 1000,
      "data": {
        "redactionInfo": {
          "isRedacted": true,
          "reason": "text",
          "canReveal": true
        },
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "finished": true,
      "mode": "cli",
      "retryOf": 1,
      "retrySuccessId": "2",
      "startedAt": "2026-07-19T15:29:38.380Z",
      "stoppedAt": "2026-07-19T15:29:38.380Z",
      "workflowId": "1000",
      "waitTill": "2026-07-19T15:29:38.380Z",
      "customData": {},
      "status": "canceled"
    }
  ],
  "nextCursor": "MTIzZTQ1NjctZTg5Yi0xMmQzLWE0NTYtNDI2NjE0MTc0MDA"
}

Retrieve an execution

get

Retrieve an execution from your instance.

Authorizations

X-N8N-API-KEYstringRequired

Path parameters

idnumberRequired

The ID of the execution.

Query parameters

includeDatabooleanOptional

Whether or not to include the execution's detailed data.

ignoreDataSizeLimitbooleanOptional

Whether to return the full execution data even if it exceeds the configured size limit (EXECUTIONS_DATA_MAX_DISPLAY_SIZE). Oversized executions are otherwise returned without their data.

redactExecutionDatabooleanOptional

Responses

200

Operation successful.

application/json

idnumberOptionalExample: 1000

finishedbooleanOptionalExample: true

modestring · enumOptionalPossible values:

retryOfnumber · nullableOptional

retrySuccessIdnumber · nullableOptionalExample: 2

startedAtstring · date-timeOptional

stoppedAtstring · date-time · nullableOptional

The time at which the execution stopped. Will only be null for executions that still have the status 'running'.

workflowIdnumberOptionalExample: 1000

waitTillstring · date-time · nullableOptional

customDataobjectOptional

statusstring · enumOptionalPossible values:

401

Unauthorized

403

Forbidden

404

The specified resource was not found.

get/executions/{id}

GET /api/v1/executions/{id} HTTP/1.1
X-N8N-API-KEY: YOUR_API_KEY
Accept: */*

{
  "id": 1000,
  "data": {
    "redactionInfo": {
      "isRedacted": true,
      "reason": "text",
      "canReveal": true
    },
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "finished": true,
  "mode": "cli",
  "retryOf": 1,
  "retrySuccessId": "2",
  "startedAt": "2026-07-19T15:29:38.380Z",
  "stoppedAt": "2026-07-19T15:29:38.380Z",
  "workflowId": "1000",
  "waitTill": "2026-07-19T15:29:38.380Z",
  "customData": {},
  "status": "canceled"
}

Delete an execution

delete

Deletes an execution from your instance.

Authorizations

X-N8N-API-KEYstringRequired

Path parameters

idnumberRequired

The ID of the execution.

Responses

200

Operation successful.

application/json

idnumberOptionalExample: 1000

finishedbooleanOptionalExample: true

modestring · enumOptionalPossible values:

retryOfnumber · nullableOptional

retrySuccessIdnumber · nullableOptionalExample: 2

startedAtstring · date-timeOptional

stoppedAtstring · date-time · nullableOptional

The time at which the execution stopped. Will only be null for executions that still have the status 'running'.

workflowIdnumberOptionalExample: 1000

waitTillstring · date-time · nullableOptional

customDataobjectOptional

statusstring · enumOptionalPossible values:

401

Unauthorized

404

The specified resource was not found.

delete/executions/{id}

DELETE /api/v1/executions/{id} HTTP/1.1
X-N8N-API-KEY: YOUR_API_KEY
Accept: */*

{
  "id": 1000,
  "data": {
    "redactionInfo": {
      "isRedacted": true,
      "reason": "text",
      "canReveal": true
    },
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "finished": true,
  "mode": "cli",
  "retryOf": 1,
  "retrySuccessId": "2",
  "startedAt": "2026-07-19T15:29:38.380Z",
  "stoppedAt": "2026-07-19T15:29:38.380Z",
  "workflowId": "1000",
  "waitTill": "2026-07-19T15:29:38.380Z",
  "customData": {},
  "status": "canceled"
}

Retry an execution

post

Retry an execution from your instance.

Authorizations

X-N8N-API-KEYstringRequired

Path parameters

idnumberRequired

The ID of the execution.

Body

loadWorkflowbooleanOptional

Whether to load the currently saved workflow to execute instead of the one saved at the time of the execution. If set to true, it will retry with the latest version of the workflow.

Responses

200

Operation successful.

application/json

idnumberOptionalExample: 1000

finishedbooleanOptionalExample: true

modestring · enumOptionalPossible values:

retryOfnumber · nullableOptional

retrySuccessIdnumber · nullableOptionalExample: 2

startedAtstring · date-timeOptional

stoppedAtstring · date-time · nullableOptional

The time at which the execution stopped. Will only be null for executions that still have the status 'running'.

workflowIdnumberOptionalExample: 1000

waitTillstring · date-time · nullableOptional

customDataobjectOptional

statusstring · enumOptionalPossible values:

401

Unauthorized

404

The specified resource was not found.

409

Conflict

post/executions/{id}/retry

POST /api/v1/executions/{id}/retry HTTP/1.1
X-N8N-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 21

{
  "loadWorkflow": true
}

{
  "id": 1000,
  "data": {
    "redactionInfo": {
      "isRedacted": true,
      "reason": "text",
      "canReveal": true
    },
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "finished": true,
  "mode": "cli",
  "retryOf": 1,
  "retrySuccessId": "2",
  "startedAt": "2026-07-19T15:29:38.380Z",
  "stoppedAt": "2026-07-19T15:29:38.380Z",
  "workflowId": "1000",
  "waitTill": "2026-07-19T15:29:38.380Z",
  "customData": {},
  "status": "canceled"
}

Stop an execution

post

Stop an execution by id.

Authorizations

X-N8N-API-KEYstringRequired

Path parameters

idnumberRequired

The ID of the execution.

Responses

200

Operation successful.

application/json

idnumberOptionalExample: 1000

finishedbooleanOptionalExample: true

modestring · enumOptionalPossible values:

retryOfnumber · nullableOptional

retrySuccessIdnumber · nullableOptionalExample: 2

startedAtstring · date-timeOptional

stoppedAtstring · date-time · nullableOptional

The time at which the execution stopped. Will only be null for executions that still have the status 'running'.

workflowIdnumberOptionalExample: 1000

waitTillstring · date-time · nullableOptional

customDataobjectOptional

statusstring · enumOptionalPossible values:

401

Unauthorized

404

The specified resource was not found.

post/executions/{id}/stop

POST /api/v1/executions/{id}/stop HTTP/1.1
X-N8N-API-KEY: YOUR_API_KEY
Accept: */*

{
  "id": 1000,
  "data": {
    "redactionInfo": {
      "isRedacted": true,
      "reason": "text",
      "canReveal": true
    },
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "finished": true,
  "mode": "cli",
  "retryOf": 1,
  "retrySuccessId": "2",
  "startedAt": "2026-07-19T15:29:38.380Z",
  "stoppedAt": "2026-07-19T15:29:38.380Z",
  "workflowId": "1000",
  "waitTill": "2026-07-19T15:29:38.380Z",
  "customData": {},
  "status": "canceled"
}

Stop multiple executions

post

Stop multiple executions from your instance based on filter criteria.

Authorizations

X-N8N-API-KEYstringRequired

Body

workflowIdstringOptional

Optional workflow ID to filter executions. If not provided, will stop executions across all accessible workflows.

Example: 2tUt1wbLX592XDdX

startedAfterstring · date-timeOptional

Only stop executions that started after this time.

Example: 2024-01-01T00:00:00.000Z

startedBeforestring · date-timeOptional

Only stop executions that started before this time.

Example: 2024-12-31T23:59:59.999Z

Responses

200

Operation successful.

application/json

stoppednumberOptional

The number of executions that were successfully stopped.

Example: 5

400

The request is invalid or provides malformed data.

401

Unauthorized

post/executions/stop

POST /api/v1/executions/stop HTTP/1.1
X-N8N-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 158

{
  "status": [
    "queued",
    "running",
    "waiting"
  ],
  "workflowId": "2tUt1wbLX592XDdX",
  "startedAfter": "2024-01-01T00:00:00.000Z",
  "startedBefore": "2024-12-31T23:59:59.999Z"
}

{
  "stopped": 5
}

Get execution tags

get

Get annotation tags for an execution.

Authorizations

X-N8N-API-KEYstringRequired

Path parameters

idnumberRequired

The ID of the execution.

Responses

200

List of annotation tags

application/json

idstringRead-onlyOptionalExample: 2tUt1wbLX592XDdX

namestringRequiredExample: Production

createdAtstring · date-timeRead-onlyOptional

updatedAtstring · date-timeRead-onlyOptional

401

Unauthorized

404

The specified resource was not found.

get/executions/{id}/tags

GET /api/v1/executions/{id}/tags HTTP/1.1
X-N8N-API-KEY: YOUR_API_KEY
Accept: */*

[
  {
    "id": "2tUt1wbLX592XDdX",
    "name": "Production",
    "createdAt": "2026-07-19T15:29:38.380Z",
    "updatedAt": "2026-07-19T15:29:38.380Z"
  }
]

Update tags of an execution

put

Update annotation tags of an execution.

Authorizations

X-N8N-API-KEYstringRequired

Path parameters

idnumberRequired

The ID of the execution.

Bodyobject[]

idstringRequiredExample: 2tUt1wbLX592XDdX

Responses

200

List of tags after updating

application/json

idstringRead-onlyOptionalExample: 2tUt1wbLX592XDdX

namestringRequiredExample: Production

createdAtstring · date-timeRead-onlyOptional

updatedAtstring · date-timeRead-onlyOptional

400

The request is invalid or provides malformed data.

401

Unauthorized

404

The specified resource was not found.

put/executions/{id}/tags

PUT /api/v1/executions/{id}/tags HTTP/1.1
X-N8N-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 27

[
  {
    "id": "2tUt1wbLX592XDdX"
  }
]

[
  {
    "id": "2tUt1wbLX592XDdX",
    "name": "Production",
    "createdAt": "2026-07-19T15:29:38.380Z",
    "updatedAt": "2026-07-19T15:29:38.380Z"
  }
]

PreviousSecurity Policy NextWorkflow

Last updated 5 days ago

Was this helpful?