> ## 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 Custom Variables

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

Updates custom input definitions atomically through add, updateLabels, and remove.

<details>
<summary><strong>Detailed usage guidance</strong></summary>
<ul>
<li>Read get_flow_workspace.customVariables first for definitions, isUsed, canDelete, and referencePaths.</li>
<li>Each name may appear only once across all operations; overlapping or duplicate names are rejected.</li>
<li>Add requires a new name, updateLabels and remove require existing names.</li>
<li>Name and type cannot change; removal requires no references in the current tree, including branch expressions.</li>
<li>The final list supports up to 20 definitions.</li>
<li>Any invalid operation rejects the entire batch.</li>
<li>Preserves publication state, tree, saved audience/candidate values, and existing enrollment snapshots.</li>
<li>Returns all definitions and current usage.</li>
<li>If a concurrent edit conflicts, reload the workspace before retrying.</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.