update_call_instruction
Edit the wording of a standing call instruction or switch it off and back on without deleting it.
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. |
instruction_id | string (uuid) | Yes | — | The instruction's instruction_id, from list_call_instructions. |
text | string | No | — | Guidance only: the new instruction text. |
find | string | No | — | Word fix only: the new word or phrase to find. |
replace | string | No | — | Word fix only: the new replacement. |
enabled | boolean | No | — | false switches it off but keeps it; true switches it back on. |
Input Schema
{
"type": "object",
"required": [
"team_id",
"instruction_id"
],
"properties": {
"find": {
"type": "string",
"maxLength": 100,
"description": "Word fix only: the new word or phrase to find."
},
"text": {
"type": "string",
"maxLength": 300,
"description": "Guidance only: the new instruction text."
},
"enabled": {
"type": "boolean",
"description": "false switches it off but keeps it; true switches it back on."
},
"replace": {
"type": "string",
"maxLength": 200,
"description": "Word fix only: the new replacement."
},
"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_id": {
"type": "string",
"format": "uuid",
"description": "The instruction's instruction_id, from list_call_instructions."
}
}
}Output Schema
{
"type": "object",
"required": [
"instruction",
"note"
],
"properties": {
"note": {
"type": "string",
"description": "Reminder of when the change takes effect."
},
"team": {
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": "string"
}
},
"description": "Team this action applied to."
},
"instruction": {
"type": "object",
"required": [
"instruction_id",
"kind",
"scope",
"automatic_call_import_id",
"enabled",
"source",
"created_at",
"updated_at"
],
"properties": {
"find": {
"type": "string",
"description": "word_fix only: the word or phrase to correct."
},
"kind": {
"enum": [
"word_fix",
"guidance"
],
"type": "string",
"description": "word_fix corrects a recurring transcription error; guidance steers what Marcora suggests from calls."
},
"text": {
"type": "string",
"description": "guidance only: the instruction, in the user's words."
},
"scope": {
"enum": [
"default",
"automatic_call_import"
],
"type": "string",
"description": "default: applies to all the user's calls. automatic_call_import: only calls from that automatic call import."
},
"source": {
"enum": [
"settings",
"automatic_call_import",
"dismissal",
"agent"
],
"type": "string",
"description": "Where it was created: agent means saved through this tool."
},
"enabled": {
"type": "boolean",
"description": "False means saved but switched off."
},
"replace": {
"type": "string",
"description": "word_fix only: what to replace it with."
},
"created_at": {
"type": "string",
"format": "date-time",
"description": "ISO 8601."
},
"updated_at": {
"type": "string",
"format": "date-time",
"description": "ISO 8601."
},
"instruction_id": {
"type": "string",
"format": "uuid",
"description": "Id to use with update_call_instruction and remove_call_instruction."
},
"automatic_call_import_id": {
"type": [
"string",
"null"
],
"format": "uuid",
"description": "The automatic call import this is limited to, or null for the defaults."
}
}
}
}
}Instructions
Edits or switches on/off one of the user's standing call instructions. Use it to correct the wording, change a word fix, or turn an instruction off (enabled false) or back on without losing it. Get instruction_id from list_call_instructions. A word fix can change find and replace; guidance can change text; send only what changes. To make an instruction apply to a different automatic call import, remove it and add it again. Changes apply to calls processed from now on; calls already imported are not changed.