---
title: "Cancel a workflow run"
method: POST
path: "/v1/workflows/runs/{workflowRunId}/cancel"
tags: ["Workflows"]
---

# Cancel a workflow run

`POST /v1/workflows/runs/{workflowRunId}/cancel`

## Path parameters

- `workflowRunId` string, required

## Response `202`

Cancellation request accepted.

- StartWorkflowRunResponse — Returned when a workflow run is accepted. Poll `GET /v1/workflows/runs/{workflowRunId}` or subscribe to webhooks for completion.
  - `workflowRunId` string, required — Opaque workflow run id (e.g. `vg_work_...`).
  - `projectId` string, required — Id of the project created for this workflow run (e.g. `vg_proj_...`).
  - `projectUrl` string, uri, required — Deep link to open this project in the VideoGen web editor. Not required for an API-only integration: store `projectId` and use the Projects API (export, remix, metadata). Use `projectUrl` when a person should open the project in the app to review or edit it manually. The project is visible only to members of your team and any project collaborators, the same access model as a project created in the dashboard.
  - `remixActionIds` string[], required — Opaque remix action ids (e.g. `vg_rmix_...`), one per `remixActions` entry in request order. Empty when no remix actions were requested. Each runs after the video is built; poll `GET /v1/projects/{projectId}/remix-actions`.

## Other responses

- `default` — Error

---

[API](https://skmtc.dev/videogen/apis/videogen-api.md) · [All operations](https://skmtc.dev/videogen/apis/videogen-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/videogen/videogen-api/revisions/33dda0455d67/schema)