---
title: "Terminate a specific workflow run (force stop)"
method: POST
path: "/workflow/{id}/runs/{rid}/terminate"
---

# Terminate a specific workflow run (force stop)

`POST /workflow/{id}/runs/{rid}/terminate`

Force terminates a workflow run. Unlike stop/cancel, terminate immediately stops the run without allowing cleanup.

## Path parameters

- `id` string, required
- `rid` string, uuid, required

## Request body

- object
  - `reason` string — Optional reason for termination

## Response `200`

The workflow run was terminated

- TerminateWorkflowResponse
  - `terminated` boolean
  - `workflowId` string
  - `runId` string

## Other responses

- `400` — Invalid request body, query, or pagination token
- `404` — Workflow execution, workflow type, or catalog not found
- `409` — Workflow run is in a state that conflicts with the requested operation (e.g. operating on an already-terminal run, or resetting to an incomplete step).
- `500` — Internal server error (e.g. Temporal connection failure)

---

[API](https://skmtc.net/growthxai/apis/output-ai-api.md) · [All operations](https://skmtc.net/growthxai/apis/output-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/growthxai/output-ai-api/versions/09a49e598435/schema)