> 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/executions.md).

# Executions

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":"Executions","description":"Operations about executions"}],"servers":[{"url":"/api/v1","description":"Current n8n instance (self-hosted built-in playground)"},{"url":"{url}/api/v1","description":"Self-hosted n8n instance","variables":{"url":{"default":"https://example.com"}}}],"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-N8N-API-KEY"},"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"},"CookieAuth":{"type":"apiKey","in":"cookie","name":"n8n-auth"}},"parameters":{"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"}}},"responses":{"badRequest":{"description":"The request is invalid or provides malformed data."},"unauthorized":{"description":"Unauthorized"},"forbidden":{"description":"Forbidden"},"notFound":{"description":"The specified resource was not found."}}},"paths":{"/executions":{"get":{"operationId":"getExecutions","tags":["Executions"],"summary":"Retrieve all executions","description":"Retrieve all executions from your instance.","parameters":[{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/cursor"},{"schema":{"type":"string","enum":["true","false"],"default":"false","description":"Whether or not to include the execution's detailed data."},"required":false,"name":"includeData","in":"query"},{"schema":{"type":"string","enum":["true","false"],"default":"false","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,"name":"ignoreDataSizeLimit","in":"query"},{"schema":{"type":"string","enum":["true","false"],"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."},"required":false,"name":"redactExecutionData","in":"query"},{"schema":{"type":"string","enum":["canceled","crashed","error","new","running","success","unknown","waiting"],"description":"Status to filter the executions by."},"required":false,"name":"status","in":"query"},{"schema":{"type":"string","description":"Workflow to filter the executions by."},"required":false,"name":"workflowId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"projectId","in":"query"},{"schema":{"type":"string","format":"date-time","description":"Only return executions that started after this time."},"required":false,"name":"startedAfter","in":"query"},{"schema":{"type":"string","format":"date-time","description":"Only return executions that started before this time."},"required":false,"name":"startedBefore","in":"query"}],"responses":{"200":{"description":"Operation successful.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"finished":{"type":"boolean","description":"Whether the execution ran to completion. Use `status` instead.","deprecated":true},"mode":{"type":"string","enum":["cli","error","integrated","internal","manual","retry","trigger","webhook","evaluation","chat","agent"]},"retryOf":{"type":"string","nullable":true,"description":"ID of the execution this one is a retry of."},"retrySuccessId":{"type":"string","nullable":true,"description":"ID of the retry that succeeded, if this execution failed and a retry did not."},"status":{"type":"string","enum":["canceled","crashed","error","new","running","success","unknown","waiting"]},"startedAt":{"type":"string","nullable":true,"format":"date-time","description":"Null until the execution leaves the queue and starts running."},"stoppedAt":{"type":"string","nullable":true,"format":"date-time","description":"When the execution stopped. Null for the `new`, `running` and `unknown` statuses; a `waiting` execution has stopped its current run, so it has a value."},"workflowId":{"type":"string"},"waitTill":{"type":"string","nullable":true,"format":"date-time","description":"The time at which a waiting execution resumes."},"storedAt":{"type":"string","description":"Where the execution data is stored.","enum":["db","fs","s3","az"]},"jsonSizeBytes":{"type":"number","description":"Size of the stored execution data in bytes. 0 means unknown."},"workflowVersionId":{"type":"string","nullable":true,"description":"ID of the workflow version this execution ran."},"data":{"type":"object","description":"Detailed execution data. Only included when `includeData` is `true`.","additionalProperties":true,"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."}}}}},"workflowData":{"type":"object","description":"The workflow as it was saved when the execution ran. Only included when `includeData` is `true`. Older executions carry more fields than newer ones.","additionalProperties":true},"customData":{"type":"object","description":"Execution metadata set by the workflow. Only included when `includeData` is `true`.","additionalProperties":{"type":"string"}},"dataTooLargeToDisplay":{"type":"boolean","description":"Present and true when the execution data was larger than `EXECUTIONS_DATA_MAX_DISPLAY_SIZE`. `data` is then empty and `jsonSizeBytes` holds the real size. Use `ignoreDataSizeLimit` to read it anyway."}},"required":["id","finished","mode","retryOf","retrySuccessId","status","startedAt","stoppedAt","workflowId","waitTill"]}},"nextCursor":{"type":"string","nullable":true,"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."}},"required":["data","nextCursor"]}}}},"400":{"$ref":"#/components/responses/badRequest"},"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":"Executions","description":"Operations about executions"}],"servers":[{"url":"/api/v1","description":"Current n8n instance (self-hosted built-in playground)"},{"url":"{url}/api/v1","description":"Self-hosted n8n instance","variables":{"url":{"default":"https://example.com"}}}],"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-N8N-API-KEY"},"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"},"CookieAuth":{"type":"apiKey","in":"cookie","name":"n8n-auth"}},"responses":{"badRequest":{"description":"The request is invalid or provides malformed data."},"unauthorized":{"description":"Unauthorized"},"forbidden":{"description":"Forbidden"},"notFound":{"description":"The specified resource was not found."}}},"paths":{"/executions/{executionId}":{"get":{"operationId":"getExecution","tags":["Executions"],"summary":"Retrieve an execution","description":"Retrieve an execution from your instance.","parameters":[{"schema":{"type":"integer","minimum":1},"required":true,"description":"The ID of the execution.","name":"executionId","in":"path"},{"schema":{"type":"string","enum":["true","false"],"default":"false","description":"Whether or not to include the execution's detailed data."},"required":false,"name":"includeData","in":"query"},{"schema":{"type":"string","enum":["true","false"],"default":"false","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,"name":"ignoreDataSizeLimit","in":"query"},{"schema":{"type":"string","enum":["true","false"],"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."},"required":false,"name":"redactExecutionData","in":"query"}],"responses":{"200":{"description":"Operation successful.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"finished":{"type":"boolean","description":"Whether the execution ran to completion. Use `status` instead.","deprecated":true},"mode":{"type":"string","enum":["cli","error","integrated","internal","manual","retry","trigger","webhook","evaluation","chat","agent"]},"retryOf":{"type":"string","nullable":true,"description":"ID of the execution this one is a retry of."},"retrySuccessId":{"type":"string","nullable":true,"description":"ID of the retry that succeeded, if this execution failed and a retry did not."},"status":{"type":"string","enum":["canceled","crashed","error","new","running","success","unknown","waiting"]},"createdAt":{"type":"string","format":"date-time"},"startedAt":{"type":"string","nullable":true,"format":"date-time","description":"Null until the execution leaves the queue and starts running."},"stoppedAt":{"type":"string","nullable":true,"format":"date-time","description":"When the execution stopped. Null for the `new`, `running` and `unknown` statuses; a `waiting` execution has stopped its current run, so it has a value."},"deletedAt":{"type":"string","nullable":true,"format":"date-time","description":"Always null. Soft-deleted executions are not returned."},"workflowId":{"type":"string"},"waitTill":{"type":"string","nullable":true,"format":"date-time","description":"The time at which a waiting execution resumes."},"storedAt":{"type":"string","description":"Where the execution data is stored.","enum":["db","fs","s3","az"]},"tracingContext":{"type":"object","nullable":true,"properties":{"traceparent":{"type":"string"},"tracestate":{"type":"string"}},"required":["traceparent"],"description":"W3C trace context propagated with the execution."},"deduplicationKey":{"type":"string","nullable":true,"description":"Key used to stop a duplicate execution from being created."},"jsonSizeBytes":{"type":"number","description":"Size of the stored execution data in bytes. 0 means unknown."},"binaryDataSizeBytes":{"type":"number","description":"Size of the stored binary data in bytes. 0 means unknown."},"workflowVersionId":{"type":"string","nullable":true,"description":"ID of the workflow version this execution ran."},"usedPrivateCredentials":{"type":"boolean","description":"Whether the execution used credentials that are not shared with the project."},"data":{"type":"object","description":"Detailed execution data. Only included when `includeData` is `true`.","additionalProperties":true,"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."}}}}},"customData":{"type":"object","description":"Execution metadata set by the workflow. Only included when `includeData` is `true`.","additionalProperties":{"type":"string"}},"workflowData":{"type":"object","description":"The workflow as it was saved when the execution ran. Only included when `includeData` is `true`. Older executions carry more fields than newer ones.","additionalProperties":true},"dataTooLargeToDisplay":{"type":"boolean","description":"Present and true when the execution data was larger than `EXECUTIONS_DATA_MAX_DISPLAY_SIZE`. `data` is then empty and `jsonSizeBytes` holds the real size. Use `ignoreDataSizeLimit` to read it anyway."}},"required":["id","finished","mode","retryOf","retrySuccessId","status","createdAt","startedAt","stoppedAt","deletedAt","workflowId","waitTill","storedAt","tracingContext","deduplicationKey","jsonSizeBytes","binaryDataSizeBytes","workflowVersionId","usedPrivateCredentials"]}}}},"400":{"$ref":"#/components/responses/badRequest"},"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":"Executions","description":"Operations about executions"}],"servers":[{"url":"/api/v1","description":"Current n8n instance (self-hosted built-in playground)"},{"url":"{url}/api/v1","description":"Self-hosted n8n instance","variables":{"url":{"default":"https://example.com"}}}],"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-N8N-API-KEY"},"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"},"CookieAuth":{"type":"apiKey","in":"cookie","name":"n8n-auth"}},"responses":{"badRequest":{"description":"The request is invalid or provides malformed data."},"unauthorized":{"description":"Unauthorized"},"forbidden":{"description":"Forbidden"},"notFound":{"description":"The specified resource was not found."}}},"paths":{"/executions/{executionId}":{"delete":{"operationId":"deleteExecution","tags":["Executions"],"summary":"Delete an execution","description":"Deletes an execution from your instance.","parameters":[{"schema":{"type":"integer","minimum":1},"required":true,"description":"The ID of the execution.","name":"executionId","in":"path"}],"responses":{"200":{"description":"Operation successful.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"number","description":"ID of the deleted execution. This endpoint returns it as a number, where every other execution endpoint returns a string."},"finished":{"type":"boolean","description":"Whether the execution ran to completion. Use `status` instead.","deprecated":true},"mode":{"type":"string","enum":["cli","error","integrated","internal","manual","retry","trigger","webhook","evaluation","chat","agent"]},"retryOf":{"type":"string","nullable":true,"description":"ID of the execution this one is a retry of."},"retrySuccessId":{"type":"string","nullable":true,"description":"ID of the retry that succeeded, if this execution failed and a retry did not."},"status":{"type":"string","enum":["canceled","crashed","error","new","running","success","unknown","waiting"]},"createdAt":{"type":"string","format":"date-time"},"startedAt":{"type":"string","nullable":true,"format":"date-time","description":"Null until the execution leaves the queue and starts running."},"stoppedAt":{"type":"string","nullable":true,"format":"date-time","description":"When the execution stopped. Null for the `new`, `running` and `unknown` statuses; a `waiting` execution has stopped its current run, so it has a value."},"deletedAt":{"type":"string","nullable":true,"format":"date-time","description":"Always null. Soft-deleted executions are not returned."},"workflowId":{"type":"string"},"waitTill":{"type":"string","nullable":true,"format":"date-time","description":"The time at which a waiting execution resumes."},"storedAt":{"type":"string","description":"Where the execution data is stored.","enum":["db","fs","s3","az"]},"tracingContext":{"type":"object","nullable":true,"properties":{"traceparent":{"type":"string"},"tracestate":{"type":"string"}},"required":["traceparent"],"description":"W3C trace context propagated with the execution."},"deduplicationKey":{"type":"string","nullable":true,"description":"Key used to stop a duplicate execution from being created."},"jsonSizeBytes":{"type":"number","description":"Size of the stored execution data in bytes. 0 means unknown."},"binaryDataSizeBytes":{"type":"number","description":"Size of the stored binary data in bytes. 0 means unknown."},"workflowVersionId":{"type":"string","nullable":true,"description":"ID of the workflow version this execution ran."},"usedPrivateCredentials":{"type":"boolean","description":"Whether the execution used credentials that are not shared with the project."}},"required":["id","finished","mode","retryOf","retrySuccessId","status","createdAt","startedAt","stoppedAt","deletedAt","workflowId","waitTill","storedAt","tracingContext","deduplicationKey","jsonSizeBytes","binaryDataSizeBytes","workflowVersionId","usedPrivateCredentials"]}}}},"400":{"$ref":"#/components/responses/badRequest"},"401":{"$ref":"#/components/responses/unauthorized"},"403":{"$ref":"#/components/responses/forbidden"},"404":{"$ref":"#/components/responses/notFound"}}}}}}
```

## 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":"Executions","description":"Operations about executions"}],"servers":[{"url":"/api/v1","description":"Current n8n instance (self-hosted built-in playground)"},{"url":"{url}/api/v1","description":"Self-hosted n8n instance","variables":{"url":{"default":"https://example.com"}}}],"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-N8N-API-KEY"},"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"},"CookieAuth":{"type":"apiKey","in":"cookie","name":"n8n-auth"}},"schemas":{"executionTagsPublicDto.generated":{"type":"array","items":{"type":"object","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}},"required":["id","name","createdAt","updatedAt"]}}},"responses":{"badRequest":{"description":"The request is invalid or provides malformed data."},"unauthorized":{"description":"Unauthorized"},"forbidden":{"description":"Forbidden"},"notFound":{"description":"The specified resource was not found."}}},"paths":{"/executions/{executionId}/tags":{"get":{"operationId":"getExecutionTags","tags":["Executions"],"summary":"Get execution tags","description":"Get annotation tags for an execution.","parameters":[{"schema":{"type":"integer","minimum":1},"required":true,"description":"The ID of the execution.","name":"executionId","in":"path"}],"responses":{"200":{"description":"Operation successful.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/executionTagsPublicDto.generated"}}}},"400":{"$ref":"#/components/responses/badRequest"},"401":{"$ref":"#/components/responses/unauthorized"},"403":{"$ref":"#/components/responses/forbidden"},"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":"Executions","description":"Operations about executions"}],"servers":[{"url":"/api/v1","description":"Current n8n instance (self-hosted built-in playground)"},{"url":"{url}/api/v1","description":"Self-hosted n8n instance","variables":{"url":{"default":"https://example.com"}}}],"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-N8N-API-KEY"},"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"},"CookieAuth":{"type":"apiKey","in":"cookie","name":"n8n-auth"}},"schemas":{"executionTagsPublicDto.generated":{"type":"array","items":{"type":"object","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}},"required":["id","name","createdAt","updatedAt"]}}},"responses":{"badRequest":{"description":"The request is invalid or provides malformed data."},"unauthorized":{"description":"Unauthorized"},"forbidden":{"description":"Forbidden"},"notFound":{"description":"The specified resource was not found."},"unsupportedMediaType":{"description":"Unsupported media type."}}},"paths":{"/executions/{executionId}/tags":{"put":{"operationId":"updateExecutionTags","tags":["Executions"],"summary":"Update tags of an execution","description":"Update annotation tags of an execution.","parameters":[{"schema":{"type":"integer","minimum":1},"required":true,"description":"The ID of the execution.","name":"executionId","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"}},"required":["id"],"additionalProperties":false}}}}},"responses":{"200":{"description":"Operation successful.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/executionTagsPublicDto.generated"}}}},"400":{"$ref":"#/components/responses/badRequest"},"401":{"$ref":"#/components/responses/unauthorized"},"403":{"$ref":"#/components/responses/forbidden"},"404":{"$ref":"#/components/responses/notFound"},"415":{"$ref":"#/components/responses/unsupportedMediaType"}}}}}}
```

## 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":"Executions","description":"Operations about executions"}],"servers":[{"url":"/api/v1","description":"Current n8n instance (self-hosted built-in playground)"},{"url":"{url}/api/v1","description":"Self-hosted n8n instance","variables":{"url":{"default":"https://example.com"}}}],"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-N8N-API-KEY"},"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"},"CookieAuth":{"type":"apiKey","in":"cookie","name":"n8n-auth"}},"responses":{"badRequest":{"description":"The request is invalid or provides malformed data."},"unauthorized":{"description":"Unauthorized"},"forbidden":{"description":"Forbidden"},"notFound":{"description":"The specified resource was not found."},"unsupportedMediaType":{"description":"Unsupported media type."}}},"paths":{"/executions/stop":{"post":{"operationId":"stopManyExecutions","tags":["Executions"],"summary":"Stop multiple executions","description":"Stop multiple executions from your instance based on filter criteria.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"array","items":{"type":"string","enum":["queued","running","waiting"]},"minItems":1,"description":"Array of execution statuses to stop. Must include at least one status."},"workflowId":{"type":"string","description":"Optional workflow ID to filter executions. If not provided, will stop executions across all accessible workflows. The literal value `all` has the same effect as omitting it."},"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."}},"required":["status"]}}}},"responses":{"200":{"description":"Operation successful.","content":{"application/json":{"schema":{"type":"object","properties":{"stopped":{"type":"integer","description":"The number of executions that were successfully stopped."}},"required":["stopped"]}}}},"400":{"$ref":"#/components/responses/badRequest"},"401":{"$ref":"#/components/responses/unauthorized"},"403":{"$ref":"#/components/responses/forbidden"},"404":{"$ref":"#/components/responses/notFound"},"415":{"$ref":"#/components/responses/unsupportedMediaType"}}}}}}
```

## Stop an execution

> Stop an execution by id.

```json
{"openapi":"3.0.0","info":{"title":"n8n Public API","version":"1.1.1"},"tags":[{"name":"Executions","description":"Operations about executions"}],"servers":[{"url":"/api/v1","description":"Current n8n instance (self-hosted built-in playground)"},{"url":"{url}/api/v1","description":"Self-hosted n8n instance","variables":{"url":{"default":"https://example.com"}}}],"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-N8N-API-KEY"},"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"},"CookieAuth":{"type":"apiKey","in":"cookie","name":"n8n-auth"}},"responses":{"badRequest":{"description":"The request is invalid or provides malformed data."},"unauthorized":{"description":"Unauthorized"},"forbidden":{"description":"Forbidden"},"notFound":{"description":"The specified resource was not found."},"conflict":{"description":"Conflict"}}},"paths":{"/executions/{executionId}/stop":{"post":{"operationId":"stopExecution","tags":["Executions"],"summary":"Stop an execution","description":"Stop an execution by id.","parameters":[{"schema":{"type":"integer","minimum":1},"required":true,"description":"The ID of the execution.","name":"executionId","in":"path"}],"responses":{"200":{"description":"Operation successful.","content":{"application/json":{"schema":{"type":"object","properties":{"mode":{"type":"string","enum":["cli","error","integrated","internal","manual","retry","trigger","webhook","evaluation","chat","agent"]},"startedAt":{"type":"string","format":"date-time","description":"The time at which the execution started."},"stoppedAt":{"type":"string","format":"date-time","description":"The time at which the execution stopped. Absent when no stop time was recorded."},"finished":{"type":"boolean","description":"Whether the execution ran to completion. Use `status` instead.","deprecated":true},"status":{"type":"string","enum":["canceled","crashed","error","new","running","success","unknown","waiting"]}},"required":["mode","startedAt","finished","status"]}}}},"400":{"$ref":"#/components/responses/badRequest"},"401":{"$ref":"#/components/responses/unauthorized"},"403":{"$ref":"#/components/responses/forbidden"},"404":{"$ref":"#/components/responses/notFound"},"409":{"$ref":"#/components/responses/conflict"}}}}}}
```

## 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":"Executions","description":"Operations about executions"}],"servers":[{"url":"/api/v1","description":"Current n8n instance (self-hosted built-in playground)"},{"url":"{url}/api/v1","description":"Self-hosted n8n instance","variables":{"url":{"default":"https://example.com"}}}],"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"CookieAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-N8N-API-KEY"},"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"},"CookieAuth":{"type":"apiKey","in":"cookie","name":"n8n-auth"}},"responses":{"badRequest":{"description":"The request is invalid or provides malformed data."},"unauthorized":{"description":"Unauthorized"},"forbidden":{"description":"Forbidden"},"notFound":{"description":"The specified resource was not found."},"conflict":{"description":"Conflict"},"unsupportedMediaType":{"description":"Unsupported media type."}}},"paths":{"/executions/{executionId}/retry":{"post":{"operationId":"retryExecution","tags":["Executions"],"summary":"Retry an execution","description":"Retry an execution from your instance.","parameters":[{"schema":{"type":"integer","minimum":1},"required":true,"description":"The ID of the execution.","name":"executionId","in":"path"}],"requestBody":{"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":{"type":"object","properties":{"id":{"type":"string","description":"ID of the new execution that the retry started."},"mode":{"type":"string","enum":["cli","error","integrated","internal","manual","retry","trigger","webhook","evaluation","chat","agent"]},"startedAt":{"type":"string","nullable":true,"format":"date-time","description":"The time at which the new execution started."},"workflowId":{"type":"string"},"finished":{"type":"boolean","description":"Whether the execution ran to completion. Use `status` instead.","deprecated":true},"retryOf":{"type":"string","nullable":true,"description":"ID of the execution this one is a retry of."},"status":{"type":"string","enum":["canceled","crashed","error","new","running","success","unknown","waiting"]},"waitTill":{"type":"string","nullable":true,"format":"date-time","description":"The time at which a waiting execution resumes."},"data":{"type":"object","description":"Run data of the new execution.","additionalProperties":true,"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."}}}}},"workflowData":{"type":"object","description":"The workflow as it was saved when the original execution ran. `loadWorkflow` changes which workflow the retry runs, not what this field reports.","additionalProperties":true},"customData":{"type":"object","description":"Execution metadata carried over from the original execution.","additionalProperties":{"type":"string"}},"annotation":{"type":"object","properties":{"id":{"type":"number"},"vote":{"type":"string","nullable":true,"description":"Vote left on the original execution.","enum":["up","down"]},"tags":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]}}},"required":["id","vote","tags"],"description":"Annotation on the original execution. Absent when it carries none."},"storedAt":{"type":"string","description":"Where the execution data is stored.","enum":["db","fs","s3","az"]}},"required":["id","mode","startedAt","workflowId","finished","retryOf","status","data","workflowData","customData","storedAt"]}}}},"400":{"$ref":"#/components/responses/badRequest"},"401":{"$ref":"#/components/responses/unauthorized"},"403":{"$ref":"#/components/responses/forbidden"},"404":{"$ref":"#/components/responses/notFound"},"409":{"$ref":"#/components/responses/conflict"},"415":{"$ref":"#/components/responses/unsupportedMediaType"}}}}}}
```