← All playbooks · Raw API

task-publish-handoff

# Capability: Publish handoff

## Intent phrases

- publish changes
- go live
- make changes live

## Requires capabilities

Always available.

## What cms-edit does

- Creates and updates **drafts only**
- **Cannot** publish, unpublish, archive, or delete published entries

## Handoff steps

1. Ensure all edits are saved (`diff` was reviewed)
2. Run `cms_edit ["preview", "urls", "<slug>"]` (or use session entry id after save)
3. Give the user **both** links:
   - **Live preview (publish here)** — `app.contentful.com/.../entries/.../preview/...` — open this to review and click the green **Publish** button at the top
   - **Preview (staging site)** — full staging URL for a full-page check (optional)
4. Tell the user which entry was changed (title, slug, CMS label)
5. Remind them: production URL updates 1–3 minutes after publish

## Confirmation gates

1. Never claim changes are live until a human publishes
2. Always include the **Live preview** link when `contentfulLivePreview` is available
3. List draft entries awaiting publish

## Out of scope

- Automated publish (intentionally unsupported)

## Related resources

- `cms-edit://customer/task-preview-verify`
- `cms-edit://customer/overview`