update_playbook_step_status
Complete a content or checklist playbook cycle step (with optional result_url and note) or reopen a completed checklist step back to Accepted.
Parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
team_id | integer | Yes | — | Team id to act in (from initialize instructions or get_current_user_info). Required on external MCP; optional in bound sessions. |
plan_uuid | string (uuid) | Yes | — | Cycle step plan_uuid (from get_playbook_cycle or list_my_playbook_steps). |
action | string | Yes | — | complete = mark step Complete (action steps require result_url + note); reopen = checklist steps only, returns to Accepted and clears evidence. |
result_url | string | No | — | http/https link to what was done (e.g. a Slack post or confirmation page). Include whenever a URL is given (REQUIRED for action steps on complete; optional only when no URL exists). Rejected on reopen. |
note | string | No | — | Optional for content/checklist; REQUIRED for action steps on complete (what was done). Rejected on reopen. |
Input Schema
{
"type": "object",
"required": [
"team_id",
"plan_uuid",
"action"
],
"properties": {
"note": {
"type": "string",
"description": "Optional for content/checklist; REQUIRED for action steps on complete (what was done). Rejected on reopen."
},
"action": {
"enum": [
"complete",
"reopen"
],
"type": "string",
"description": "complete = mark step Complete (action steps require result_url + note); reopen = checklist steps only, returns to Accepted and clears evidence."
},
"team_id": {
"type": "integer",
"minimum": 1,
"description": "Team id to act in (from initialize instructions or get_current_user_info). Required on external MCP; optional in bound sessions."
},
"plan_uuid": {
"type": "string",
"format": "uuid",
"description": "Cycle step plan_uuid (from get_playbook_cycle or list_my_playbook_steps)."
},
"result_url": {
"type": "string",
"description": "http/https link to what was done (e.g. a Slack post or confirmation page). Include whenever a URL is given (REQUIRED for action steps on complete; optional only when no URL exists). Rejected on reopen."
}
}
}Output Schema
{
"type": "object",
"required": [
"plan_uuid",
"stage",
"title",
"run_id",
"link_url",
"cycle_link_url"
],
"properties": {
"note": {
"type": [
"string",
"null"
]
},
"team": {
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": "string"
}
},
"description": "Team this action applied to."
},
"stage": {
"enum": [
"Accepted",
"Complete"
],
"type": "string"
},
"title": {
"type": "string"
},
"run_id": {
"type": "integer"
},
"link_url": {
"type": "string"
},
"plan_uuid": {
"type": "string",
"format": "uuid"
},
"result_url": {
"type": [
"string",
"null"
]
},
"completed_at": {
"type": [
"integer",
"null"
]
},
"completed_by": {
"type": [
"integer",
"null"
]
},
"cycle_link_url": {
"type": "string"
}
}
}Instructions
Updates a playbook cycle step's completion status (plan_uuid from get_playbook_cycle or list_my_playbook_steps). Does NOT handle general plan edits (use update_plan for title, prompt, due date, assignee, targeting, or Dismissed).
Actions (action, required)
complete: markscontentorcheckliststepsCompleteand records proof via optionalresult_urlandnote. Openactionsteps cannot be completed over external MCP (always refused with"Complete this action from its current Marcora conversation"); action steps are completed only inside a Marcora conversation (requiring bothresult_urlandnote). RefusesDismissedsteps (409) and plans that are not playbook cycle steps. Repeatingcompletekeeps originalcompleted_at/completed_bywhile newly suppliedresult_url/noteoverwrite previous values (omit them to preserve recorded values).reopen: checklist steps only (refusescontentandactionsteps with 409); returnsCompleteback toAcceptedand clears recorded completion evidence. Rejectsresult_url/noteif sent.
Requires edit access (step assignee or creator). Present link_url as returned.
When to use
When the user wants to mark a cycle step complete with proof (action: "complete") or untick a completed checklist step (action: "reopen"). Find plan_uuid via get_playbook_cycle or list_my_playbook_steps.
Links: present link_url to the user exactly as returned — copy it character for character. Never retype, shorten, or rebuild a link or the IDs inside it.