Version
DESTRUCTIVE

delete_sequence

Put a win-back sequence out of use. Destructive; every member part-way through leaves it, the history stays for the figures, and the id stops answering. Emits sequence.deleted.

Delete a sequence the creator no longer wants. Every member part-way through leaves it at once, as sequence.exited with the reason deleted; the row and its ledger rows stay, so the figures on get_retention_stats do not move; and the id stops answering. sequence.deleted emits once.

Destructive — confirm with a human first

Never undone: build a new sequence instead. To stop a sequence without losing it, set active to false with update_sequence, which keeps the steps and lets the creator switch it back on.

A second call on the same id answers RESOURCE_NOT_FOUND, exactly as an unknown or out-of-scope sequence does.

Requires ability

The token behind the MCP session must hold it, or the call is refused with TOKEN_MISSING_ABILITY.

The REST endpoint and this tool share one action, so validation, permissions and events are identical.

Delivered to every endpoint subscribed to it once the change is made.

Annotations

Destructive

A client that honours annotations asks a person before running it.

Arguments

project_id*string

UUID of the project the sequence belongs to.

sequence_id*string

UUID of the sequence to delete.

What it returns

{  "data": {    "id": "9d2f4b6a-1c3e-4f58-8a7b-6e5d4c3b2a19",    "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13",    "name": "Win-back after churn",    "trigger": "churned",    "active": true,    "steps": [      { "id": "4e8a2c6d-7b1f-4d93-a5c0-8f2e1b7d6c54", "position": 1, "delay_days": 3, "body": "Hi {name}, your place in {project} is still here whenever you want it back: {link}", "coupon": null }    ],    "counts": { "enrolled": 12, "open": 0, "completed": 6, "won_back": 2 },    "created_at": "2026-10-01T09:00:00+00:00",    "updated_at": "2026-10-12T09:05:00+00:00",    "deleted_at": "2026-10-12T09:05:00+00:00"  }}

How it fails

RESOURCE_NOT_FOUND

unknown project_id or sequence_id, a sequence of another project, or one already deleted.

AUTHENTICATION_REQUIRED

no authenticated user on the request.

TOKEN_MISSING_ABILITY

token lacks project-sequence:delete.

How is this guide?

Last updated on