dismiss_playbook_suggestion
Dismiss a call-detected playbook suggestion so that initiative and occurrence will not be suggested again, optionally saving a standing call-guidance instruction.
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. |
suggestion_id | string (uuid) | Yes | — | UUID of the playbook suggestion to dismiss (from list_playbook_suggestions). |
instruction | object | No | — | Optional standing call-guidance rule to save atomically on first dismissal. Omit to dismiss only this initiative. |
Input Schema
{
"type": "object",
"required": [
"team_id",
"suggestion_id"
],
"properties": {
"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."
},
"instruction": {
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "One-line guidance rule (no line breaks, 1-300 characters) applied to future calls."
}
},
"description": "Optional standing call-guidance rule to save atomically on first dismissal. Omit to dismiss only this initiative."
},
"suggestion_id": {
"type": "string",
"format": "uuid",
"description": "UUID of the playbook suggestion to dismiss (from list_playbook_suggestions)."
}
}
}Output Schema
{
"type": "object",
"required": [
"suggestion"
],
"properties": {
"team": {
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": "string"
}
},
"description": "Team this action applied to."
},
"suggestion": {
"type": "object",
"required": [
"id",
"initiative",
"playbook",
"call",
"visibility",
"variables",
"anchor_date",
"supporting_quote",
"status",
"run",
"created_at",
"updated_at"
],
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"run": {
"type": [
"object",
"null"
],
"required": [
"playbook_run_uuid",
"link_url"
],
"properties": {
"link_url": {
"type": "string"
},
"playbook_run_uuid": {
"type": "string",
"format": "uuid"
}
}
},
"call": {
"type": "object",
"required": [
"context_item_id",
"name"
],
"properties": {
"name": {
"type": "string"
},
"context_item_id": {
"type": "string",
"format": "uuid"
}
}
},
"status": {
"enum": [
"suggested",
"started",
"dismissed"
],
"type": "string"
},
"coverage": {
"type": "array",
"items": {
"type": "object",
"required": [
"item_id",
"plan_uuid"
],
"properties": {
"item_id": {
"type": "integer",
"description": "Playbook step id already covered by an existing plan."
},
"plan_uuid": {
"type": "string",
"format": "uuid",
"description": "UUID of the existing plan covering that step."
}
},
"additionalProperties": false
},
"description": "Which steps the call already planned; edits to those steps are refused."
},
"playbook": {
"type": "object",
"required": [
"playbook_uuid",
"name",
"link_url"
],
"properties": {
"name": {
"type": "string"
},
"link_url": {
"type": "string"
},
"playbook_uuid": {
"type": "string",
"format": "uuid"
}
}
},
"variables": {
"type": "object",
"additionalProperties": {
"type": "string"
}
},
"created_at": {
"type": "integer",
"description": "Unix ms timestamp."
},
"initiative": {
"type": "object",
"required": [
"id",
"name",
"occurrence"
],
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"name": {
"type": "string"
},
"occurrence": {
"type": "string"
}
}
},
"updated_at": {
"type": "integer",
"description": "Unix ms timestamp."
},
"visibility": {
"enum": [
"private",
"team"
],
"type": "string"
},
"anchor_date": {
"type": [
"string",
"null"
]
},
"supporting_quote": {
"type": "string"
}
},
"additionalProperties": false
}
}
}Instructions
Dismiss a call-detected playbook suggestion (suggestion_id from list_playbook_suggestions) so that initiative and occurrence will not be suggested again.
Dismissing without instruction blocks only that specific initiative. Optionally pass instruction: { text } (one line, 1–300 chars) only when the user explicitly wants to save a standing call-guidance rule for future calls (for example, "never suggest newsletter playbooks"). Already-started suggestions are refused (409); repeating a dismissal is idempotent and ignores new instruction text.
When to use
When the user declines or dismisses a suggested playbook from a call. Get suggestion_id from list_playbook_suggestions.
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.