---
title: "Stop active cell work for a table (the API \"stop\" button)"
method: POST
path: "/tables/{tableId}/cancel"
tags: ["Workspace"]
---

# Stop active cell work for a table (the API "stop" button)

`POST /tables/{tableId}/cancel`

Cancel every active (waiting / queued / running) `cell_run` for the
table — the API equivalent of the in-app "stop" button. Running cells
finish their in-flight execution but skip further work once they observe
the cancelled status; sent history is never touched.

- Omit `columns` to stop the whole table; a full-table stop **also**
  cancels active lead-source jobs.
- Pass `columns` (an array of **column slugs** from
  `GET /tables/{tableId}/columns` → `columns[].slug`) to scope the stop
  to those columns only. A column scope deliberately leaves lead-source
  jobs running (they are table-wide, not per-column). An unknown slug →
  `UNKNOWN_COLUMN`; an empty array → `VALIDATION_ERROR`.
- `dryRun: true` reports how much is active right now
  (`{ dryRun, tableId, activeCells, activeLeadSourceJobs }`) with zero
  writes — the "what's running?" probe. `activeCells` respects the
  `columns` scope; `activeLeadSourceJobs` is always the table-wide count
  (lead-source jobs aren't per-column), so a scoped dry-run still tells
  you the truth about table activity.

This stops enrichment/score/sequence-drafting cell runs. To halt an
already-launched outreach use `POST /sequences/{sequenceId}/stop` (one
recipient) or `POST /campaigns/{campaignId}/pause` (the whole
campaign).

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `columns` string[] — Column slugs to scope the stop to. Omit to stop every column.
  - `dryRun` boolean

## Response `200`

{ tableId, cancelledCells, cancelledLeadSourceJobs } — or the dryRun report.

## Other responses

- `400` — VALIDATION_ERROR / UNKNOWN_COLUMN.
- `404` — TABLE_NOT_FOUND.
- `500` — CANCEL_PARTIALLY_FAILED — one leg failed; details carry the partial cancelledCells/cancelledLeadSourceJobs + failures[].

---

[API](https://skmtc.net/origami/apis/origami-agent-api.md) · [All operations](https://skmtc.net/origami/apis/origami-agent-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/origami/origami-agent-api/versions/8083ad7fe081/schema)
