Cancel a scheduled post

Stop a pending or scheduled assignment before it publishes.

User intents

"Cancel that post I scheduled for Friday." "Stop assignment a1b2c3d4 from going out."

Required information

The assignmentId to cancel.

Preconditions

The assignment is in a cancellable state (pending or scheduled). Already-published assignments cannot be cancelled.

Tool sequence

Find the assignment

list_assignments (filter by status: pending) or use a known assignmentId.

Check it is still cancellable

get_assignment — confirm status is pending/scheduled, not processing or published.

Cancel

cancel_assignment with the assignmentId. Status becomes cancelled.

⚠️

Cancelled assignments cannot be restarted. If the user only wants to change the time or content, use update_assignment instead of cancelling and recreating.

REST alternative

DELETE /api/v1/assignments/{id} — see the Assignments reference.

Recovery paths

404 not found — verify the ID with list_assignments.
409 conflict — the assignment is already processing/published; cancellation is no longer possible. Explain this to the user.

Example prompt → result

"Cancel my scheduled assignment a1b2c3d4 — I need to fix the video first."

Result: the assignment moves to cancelled and will not publish.

Common mistakes

Cancelling when the intent was to reschedule (use update_assignment).
Assuming a published post can be "cancelled" — it can only be edited (Update published content) or removed on the platform.

Retry a failed assignment Update published content