All MCP tools
MCP tools · Finn agents
update_finn_draft
Edits a Finn that is still a draft: name, workflow prompt, use case, language, voice, opening line, custom vocabulary, time zone and, for voice agents, call handling. Only the fields you pass change. It never changes a Finn's status, organization or call flow; a launched Finn is edited in the dashboard.
- Scope needed
- finn
- Changes data
- Yes
- Held for approval
- No
- Available to
- Every organization
Drafts only.
Inputs
| Name | Type | Description |
|---|---|---|
| finn_idrequired | string | The Finn's id (a UUID). Use list_finns to find it. |
| name | string | New display name. |
| workflowPrompt | string | The complete workflow prompt. Replaces the whole prompt, so read it with get_finn and send the edited text. |
| identityText | string | Only for older Finns with no workflow prompt: replacement role and identity text. |
| styleGuardrails | string | Only for older Finns with no workflow prompt: replacement tone and style text. |
| responseGuidelines | string | Only for older Finns with no workflow prompt: replacement response guidelines. |
| useCase | string | New short label for the Finn's purpose. |
| language | string | New primary language, e.g. 'English'. |
| voice | string | New voice id. Use list_voices to find a valid one. |
| definedBeginMessage | string | New opening line the Finn says when a call starts. |
| customVocabulary | string[] | Replaces the whole custom-vocabulary list (not merged). |
| timezone | string | IANA time zone the Finn uses for dates and times, e.g. 'Asia/Kolkata'. |
| limitCallDuration | enum: 1 min | 3 mins | 5 mins | 10 mins | 15 mins | 30 mins | 60 mins | None | Voice only: the longest a single call may run. 'None' for no limit. |
| maxIdleDuration | enum: 10s | 20s | 30s | 45s | 60s | 90s | 120s | None | Voice only: silence before the Finn says its idle reminder. 'None' turns the reminder off. |
| idleReminder | string | Voice only: what the Finn says after that silence. Empty string clears it. |
| voicemailDetection | boolean | Voice only: hang up when the call reaches a voicemail box. |