> For the complete documentation index, see [llms.txt](https://docs.n8n.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.n8n.io/connect/n8n-api/execution.md).

# Execution

Operations about executions

## Retrieve all executions

> Retrieve all executions from your instance.

```json
{"openapi":"3.0.0","info":{"title":"n8n Public API","version":"1.1.1"},"tags":[{"name":"Execution","description":"Operations about executions"}],"servers":[{"url":"/api/v1"}],"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-N8N-API-KEY"},"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"parameters":{"includeData":{"name":"includeData","in":"query","description":"Whether or not to include the execution's detailed data.","required":false,"schema":{"type":"boolean"}},"redactExecutionData":{"name":"redactExecutionData","in":"query","description":"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.\n","required":false,"schema":{"type":"boolean"}},"limit":{"name":"limit","in":"query","description":"The maximum number of items to return.","required":false,"schema":{"type":"number","default":100,"maximum":250}},"cursor":{"name":"cursor","in":"query","description":"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.","required":false,"style":"form","schema":{"type":"string"}}},"schemas":{"executionList":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/execution"}},"nextCursor":{"type":"string","description":"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.","nullable":true}}},"execution":{"type":"object","properties":{"id":{"type":"number"},"data":{"type":"object","additionalProperties":true,"description":"Detailed execution data. Only included when `includeData` is `true`.\n","properties":{"redactionInfo":{"type":"object","nullable":true,"description":"Present when execution data has been redacted.","properties":{"isRedacted":{"type":"boolean","description":"Whether the execution data was redacted."},"reason":{"type":"string","description":"The reason for redaction."},"canReveal":{"type":"boolean","description":"Whether the current user has permission to reveal the redacted data."}}}}},"finished":{"type":"boolean"},"mode":{"type":"string","enum":["cli","error","integrated","internal","manual","retry","trigger","webhook","evaluation","chat"]},"retryOf":{"type":"number","nullable":true},"retrySuccessId":{"type":"number","nullable":true},"startedAt":{"type":"string","format":"date-time"},"stoppedAt":{"type":"string","format":"date-time","nullable":true,"description":"The time at which the execution stopped. Will only be null for executions that still have the status 'running'."},"workflowId":{"type":"number"},"waitTill":{"type":"string","nullable":true,"format":"date-time"},"customData":{"type":"object"},"status":{"type":"string","enum":["canceled","crashed","error","new","running","success","unknown","waiting"]}}}},"responses":{"unauthorized":{"description":"Unauthorized"},"forbidden":{"description":"Forbidden"},"notFound":{"description":"The specified resource was not found."}}},"paths":{"/executions":{"get":{"tags":["Execution"],"summary":"Retrieve all executions","description":"Retrieve all executions from your instance.","parameters":[{"$ref":"#/components/parameters/includeData"},{"name":"ignoreDataSizeLimit","in":"query","description":"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.","required":false,"schema":{"type":"boolean"}},{"$ref":"#/components/parameters/redactExecutionData"},{"name":"status","in":"query","description":"Status to filter the executions by.","required":false,"schema":{"type":"string","enum":["canceled","crashed","error","new","running","success","unknown","waiting"]}},{"name":"workflowId","in":"query","description":"Workflow to filter the executions by.","required":false,"schema":{"type":"string"}},{"name":"projectId","in":"query","required":false,"explode":false,"allowReserved":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/cursor"}],"responses":{"200":{"description":"Operation successful.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/executionList"}}}},"401":{"$ref":"#/components/responses/unauthorized"},"403":{"$ref":"#/components/responses/forbidden"},"404":{"$ref":"#/components/responses/notFound"}}}}}}
```

## Retrieve an execution

> Retrieve an execution from your instance.

```json
{"openapi":"3.0.0","info":{"title":"n8n Public API","version":"1.1.1"},"tags":[{"name":"Execution","description":"Operations about executions"}],"servers":[{"url":"/api/v1"}],"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-N8N-API-KEY"},"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"parameters":{"executionId":{"name":"id","in":"path","description":"The ID of the execution.","required":true,"schema":{"type":"number"}},"includeData":{"name":"includeData","in":"query","description":"Whether or not to include the execution's detailed data.","required":false,"schema":{"type":"boolean"}},"redactExecutionData":{"name":"redactExecutionData","in":"query","description":"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.\n","required":false,"schema":{"type":"boolean"}}},"schemas":{"execution":{"type":"object","properties":{"id":{"type":"number"},"data":{"type":"object","additionalProperties":true,"description":"Detailed execution data. Only included when `includeData` is `true`.\n","properties":{"redactionInfo":{"type":"object","nullable":true,"description":"Present when execution data has been redacted.","properties":{"isRedacted":{"type":"boolean","description":"Whether the execution data was redacted."},"reason":{"type":"string","description":"The reason for redaction."},"canReveal":{"type":"boolean","description":"Whether the current user has permission to reveal the redacted data."}}}}},"finished":{"type":"boolean"},"mode":{"type":"string","enum":["cli","error","integrated","internal","manual","retry","trigger","webhook","evaluation","chat"]},"retryOf":{"type":"number","nullable":true},"retrySuccessId":{"type":"number","nullable":true},"startedAt":{"type":"string","format":"date-time"},"stoppedAt":{"type":"string","format":"date-time","nullable":true,"description":"The time at which the execution stopped. Will only be null for executions that still have the status 'running'."},"workflowId":{"type":"number"},"waitTill":{"type":"string","nullable":true,"format":"date-time"},"customData":{"type":"object"},"status":{"type":"string","enum":["canceled","crashed","error","new","running","success","unknown","waiting"]}}}},"responses":{"unauthorized":{"description":"Unauthorized"},"forbidden":{"description":"Forbidden"},"notFound":{"description":"The specified resource was not found."}}},"paths":{"/executions/{id}":{"get":{"tags":["Execution"],"summary":"Retrieve an execution","description":"Retrieve an execution from your instance.","parameters":[{"$ref":"#/components/parameters/executionId"},{"$ref":"#/components/parameters/includeData"},{"name":"ignoreDataSizeLimit","in":"query","description":"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.","required":false,"schema":{"type":"boolean"}},{"$ref":"#/components/parameters/redactExecutionData"}],"responses":{"200":{"description":"Operation successful.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/execution"}}}},"401":{"$ref":"#/components/responses/unauthorized"},"403":{"$ref":"#/components/responses/forbidden"},"404":{"$ref":"#/components/responses/notFound"}}}}}}
```

## Delete an execution

> Deletes an execution from your instance.

```json
{"openapi":"3.0.0","info":{"title":"n8n Public API","version":"1.1.1"},"tags":[{"name":"Execution","description":"Operations about executions"}],"servers":[{"url":"/api/v1"}],"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-N8N-API-KEY"},"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"parameters":{"executionId":{"name":"id","in":"path","description":"The ID of the execution.","required":true,"schema":{"type":"number"}}},"schemas":{"execution":{"type":"object","properties":{"id":{"type":"number"},"data":{"type":"object","additionalProperties":true,"description":"Detailed execution data. Only included when `includeData` is `true`.\n","properties":{"redactionInfo":{"type":"object","nullable":true,"description":"Present when execution data has been redacted.","properties":{"isRedacted":{"type":"boolean","description":"Whether the execution data was redacted."},"reason":{"type":"string","description":"The reason for redaction."},"canReveal":{"type":"boolean","description":"Whether the current user has permission to reveal the redacted data."}}}}},"finished":{"type":"boolean"},"mode":{"type":"string","enum":["cli","error","integrated","internal","manual","retry","trigger","webhook","evaluation","chat"]},"retryOf":{"type":"number","nullable":true},"retrySuccessId":{"type":"number","nullable":true},"startedAt":{"type":"string","format":"date-time"},"stoppedAt":{"type":"string","format":"date-time","nullable":true,"description":"The time at which the execution stopped. Will only be null for executions that still have the status 'running'."},"workflowId":{"type":"number"},"waitTill":{"type":"string","nullable":true,"format":"date-time"},"customData":{"type":"object"},"status":{"type":"string","enum":["canceled","crashed","error","new","running","success","unknown","waiting"]}}}},"responses":{"unauthorized":{"description":"Unauthorized"},"notFound":{"description":"The specified resource was not found."}}},"paths":{"/executions/{id}":{"delete":{"tags":["Execution"],"summary":"Delete an execution","description":"Deletes an execution from your instance.","parameters":[{"$ref":"#/components/parameters/executionId"}],"responses":{"200":{"description":"Operation successful.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/execution"}}}},"401":{"$ref":"#/components/responses/unauthorized"},"404":{"$ref":"#/components/responses/notFound"}}}}}}
```

## Retry an execution

> Retry an execution from your instance.

```json
{"openapi":"3.0.0","info":{"title":"n8n Public API","version":"1.1.1"},"tags":[{"name":"Execution","description":"Operations about executions"}],"servers":[{"url":"/api/v1"}],"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-N8N-API-KEY"},"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"parameters":{"executionId":{"name":"id","in":"path","description":"The ID of the execution.","required":true,"schema":{"type":"number"}}},"schemas":{"execution":{"type":"object","properties":{"id":{"type":"number"},"data":{"type":"object","additionalProperties":true,"description":"Detailed execution data. Only included when `includeData` is `true`.\n","properties":{"redactionInfo":{"type":"object","nullable":true,"description":"Present when execution data has been redacted.","properties":{"isRedacted":{"type":"boolean","description":"Whether the execution data was redacted."},"reason":{"type":"string","description":"The reason for redaction."},"canReveal":{"type":"boolean","description":"Whether the current user has permission to reveal the redacted data."}}}}},"finished":{"type":"boolean"},"mode":{"type":"string","enum":["cli","error","integrated","internal","manual","retry","trigger","webhook","evaluation","chat"]},"retryOf":{"type":"number","nullable":true},"retrySuccessId":{"type":"number","nullable":true},"startedAt":{"type":"string","format":"date-time"},"stoppedAt":{"type":"string","format":"date-time","nullable":true,"description":"The time at which the execution stopped. Will only be null for executions that still have the status 'running'."},"workflowId":{"type":"number"},"waitTill":{"type":"string","nullable":true,"format":"date-time"},"customData":{"type":"object"},"status":{"type":"string","enum":["canceled","crashed","error","new","running","success","unknown","waiting"]}}}},"responses":{"unauthorized":{"description":"Unauthorized"},"notFound":{"description":"The specified resource was not found."},"conflict":{"description":"Conflict"}}},"paths":{"/executions/{id}/retry":{"post":{"tags":["Execution"],"summary":"Retry an execution","description":"Retry an execution from your instance.","parameters":[{"$ref":"#/components/parameters/executionId"}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"loadWorkflow":{"type":"boolean","description":"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":{"description":"Operation successful.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/execution"}}}},"401":{"$ref":"#/components/responses/unauthorized"},"404":{"$ref":"#/components/responses/notFound"},"409":{"$ref":"#/components/responses/conflict"}}}}}}
```

## Stop an execution

> Stop an execution by id.

```json
{"openapi":"3.0.0","info":{"title":"n8n Public API","version":"1.1.1"},"tags":[{"name":"Execution","description":"Operations about executions"}],"servers":[{"url":"/api/v1"}],"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-N8N-API-KEY"},"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"parameters":{"executionId":{"name":"id","in":"path","description":"The ID of the execution.","required":true,"schema":{"type":"number"}}},"schemas":{"execution":{"type":"object","properties":{"id":{"type":"number"},"data":{"type":"object","additionalProperties":true,"description":"Detailed execution data. Only included when `includeData` is `true`.\n","properties":{"redactionInfo":{"type":"object","nullable":true,"description":"Present when execution data has been redacted.","properties":{"isRedacted":{"type":"boolean","description":"Whether the execution data was redacted."},"reason":{"type":"string","description":"The reason for redaction."},"canReveal":{"type":"boolean","description":"Whether the current user has permission to reveal the redacted data."}}}}},"finished":{"type":"boolean"},"mode":{"type":"string","enum":["cli","error","integrated","internal","manual","retry","trigger","webhook","evaluation","chat"]},"retryOf":{"type":"number","nullable":true},"retrySuccessId":{"type":"number","nullable":true},"startedAt":{"type":"string","format":"date-time"},"stoppedAt":{"type":"string","format":"date-time","nullable":true,"description":"The time at which the execution stopped. Will only be null for executions that still have the status 'running'."},"workflowId":{"type":"number"},"waitTill":{"type":"string","nullable":true,"format":"date-time"},"customData":{"type":"object"},"status":{"type":"string","enum":["canceled","crashed","error","new","running","success","unknown","waiting"]}}}},"responses":{"unauthorized":{"description":"Unauthorized"},"notFound":{"description":"The specified resource was not found."}}},"paths":{"/executions/{id}/stop":{"post":{"tags":["Execution"],"summary":"Stop an execution","description":"Stop an execution by id.","parameters":[{"$ref":"#/components/parameters/executionId"}],"responses":{"200":{"description":"Operation successful.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/execution"}}}},"401":{"$ref":"#/components/responses/unauthorized"},"404":{"$ref":"#/components/responses/notFound"}}}}}}
```

## Stop multiple executions

> Stop multiple executions from your instance based on filter criteria.

```json
{"openapi":"3.0.0","info":{"title":"n8n Public API","version":"1.1.1"},"tags":[{"name":"Execution","description":"Operations about executions"}],"servers":[{"url":"/api/v1"}],"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-N8N-API-KEY"},"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"responses":{"badRequest":{"description":"The request is invalid or provides malformed data."},"unauthorized":{"description":"Unauthorized"}}},"paths":{"/executions/stop":{"post":{"tags":["Execution"],"summary":"Stop multiple executions","description":"Stop multiple executions from your instance based on filter criteria.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["status"],"properties":{"status":{"type":"array","description":"Array of execution statuses to stop. Must include at least one status.","items":{"type":"string","enum":["queued","running","waiting"]}},"workflowId":{"type":"string","description":"Optional workflow ID to filter executions. If not provided, will stop executions across all accessible workflows."},"startedAfter":{"type":"string","format":"date-time","description":"Only stop executions that started after this time."},"startedBefore":{"type":"string","format":"date-time","description":"Only stop executions that started before this time."}}}}}},"responses":{"200":{"description":"Operation successful.","content":{"application/json":{"schema":{"type":"object","properties":{"stopped":{"type":"number","description":"The number of executions that were successfully stopped."}}}}}},"400":{"$ref":"#/components/responses/badRequest"},"401":{"$ref":"#/components/responses/unauthorized"}}}}}}
```

## Get execution tags

> Get annotation tags for an execution.

```json
{"openapi":"3.0.0","info":{"title":"n8n Public API","version":"1.1.1"},"tags":[{"name":"Execution","description":"Operations about executions"}],"servers":[{"url":"/api/v1"}],"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-N8N-API-KEY"},"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"parameters":{"executionId":{"name":"id","in":"path","description":"The ID of the execution.","required":true,"schema":{"type":"number"}}},"schemas":{"executionTags":{"type":"array","items":{"$ref":"#/components/schemas/tag"}},"tag":{"type":"object","additionalProperties":false,"required":["name"],"properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string"},"createdAt":{"type":"string","format":"date-time","readOnly":true},"updatedAt":{"type":"string","format":"date-time","readOnly":true}}}},"responses":{"unauthorized":{"description":"Unauthorized"},"notFound":{"description":"The specified resource was not found."}}},"paths":{"/executions/{id}/tags":{"get":{"tags":["Execution"],"summary":"Get execution tags","description":"Get annotation tags for an execution.","parameters":[{"$ref":"#/components/parameters/executionId"}],"responses":{"200":{"description":"List of annotation tags","content":{"application/json":{"schema":{"$ref":"#/components/schemas/executionTags"}}}},"401":{"$ref":"#/components/responses/unauthorized"},"404":{"$ref":"#/components/responses/notFound"}}}}}}
```

## Update tags of an execution

> Update annotation tags of an execution.

```json
{"openapi":"3.0.0","info":{"title":"n8n Public API","version":"1.1.1"},"tags":[{"name":"Execution","description":"Operations about executions"}],"servers":[{"url":"/api/v1"}],"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-N8N-API-KEY"},"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"parameters":{"executionId":{"name":"id","in":"path","description":"The ID of the execution.","required":true,"schema":{"type":"number"}}},"schemas":{"tagIds":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["id"],"properties":{"id":{"type":"string"}}}},"executionTags":{"type":"array","items":{"$ref":"#/components/schemas/tag"}},"tag":{"type":"object","additionalProperties":false,"required":["name"],"properties":{"id":{"type":"string","readOnly":true},"name":{"type":"string"},"createdAt":{"type":"string","format":"date-time","readOnly":true},"updatedAt":{"type":"string","format":"date-time","readOnly":true}}}},"responses":{"badRequest":{"description":"The request is invalid or provides malformed data."},"unauthorized":{"description":"Unauthorized"},"notFound":{"description":"The specified resource was not found."}}},"paths":{"/executions/{id}/tags":{"put":{"tags":["Execution"],"summary":"Update tags of an execution","description":"Update annotation tags of an execution.","parameters":[{"$ref":"#/components/parameters/executionId"}],"requestBody":{"description":"List of annotation tag IDs","content":{"application/json":{"schema":{"$ref":"#/components/schemas/tagIds"}}},"required":true},"responses":{"200":{"description":"List of tags after updating","content":{"application/json":{"schema":{"$ref":"#/components/schemas/executionTags"}}}},"400":{"$ref":"#/components/responses/badRequest"},"401":{"$ref":"#/components/responses/unauthorized"},"404":{"$ref":"#/components/responses/notFound"}}}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.n8n.io/connect/n8n-api/execution.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.