> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firsttouch.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> For API operations, fetch https://gateway.firsttouch.ai/api/public/openapi.json for the complete input/output schemas, internal references, and x-mcp-annotations. Endpoint Markdown intentionally omits generated schema fragments. Select /api/public/tools/<tool_name> using the exact underscore-separated name. Send requests to https://gateway.firsttouch.ai; the canonical document currently omits servers. Start at https://docs.firsttouch.com/api-reference/agent-start.md.

# Update Flow Plan Settings

> Requires the admin team role or global admin access. Check get_current_user.toolAccess before calling.

Update an existing reusable Flow Plan's name, options, AI qualification, or candidate assignees.

<details>
<summary><strong>Detailed usage guidance</strong></summary>
<ul>
<li>Read get_flow_workspace first to inspect the current settings.</li>
<li>Omitted top-level settings keep their current values; supplied options and aiQualification replace their complete blocks, and candidates replaces the complete candidate list.</li>
<li>Removing candidate assignees can move their affected enrollments to failed.</li>
<li>A name-only or no-op update preserves the current published/draft state.</li>
<li>Any configuration change moves a published reusable flow to Draft, pausing new enrollments until a separate manage_flow_publication call publishes it again.</li>
<li>This tool does not replace the root, attach an audience, publish a flow, or explicitly enroll contacts.</li>
<li>Enrichment and CRM options configure subsequent execution, which may consume FirstTouch credits or write to the connected CRM; setting them does not itself run those operations.</li>
<li>For the shared contact-sequence Flow Plan, only mcpDynamicActionsOptions.is_enrich_hubspot and mcpDynamicActionsOptions.is_push_to_hubspot_tasks are allowed.</li>
<li>These are shared settings, not per-action or per-enrollment overrides.</li>
<li>The task setting controls call, manual, and approval task sync together; omitted flags keep their current values, and all other fields for that system flow are rejected.</li>
</ul>
</details>



## API Specification

The full API specification for this endpoint is available in the [documentation index](https://docs.firsttouch.com/llms.txt).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.