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

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

Updates saved inputs for 1 to 100 unique enrollment candidates in the current team and the specified flowPlanId.

<details>
<summary><strong>Detailed usage guidance</strong></summary>
<ul>
<li>One type applies to all items: upsert adds or overwrites supplied customVariables while preserving all other keys; remove deletes supplied keys, with missing keys a no-op.</li>
<li>Each candidate commits independently; returns updated ids and failed items with candidateId, code, and actionable message.</li>
<li>Malformed shapes or duplicate ids reject the whole request before any updates.</li>
<li>Allowed only while Awaiting, before enrollment is requested or created.</li>
<li>Upsert values for keys with current flow definitions must match their declared types; unknown keys and incomplete required inputs are allowed during preparation.</li>
<li>The final dictionary supports up to 20 values, strings up to 10000 characters, 20 KiB total; values must be strings without curly braces, integers, or booleans.</li>
<li>Does not modify audience contacts, definitions, or existing enrollment snapshots and does not enroll candidates.</li>
<li>Failure codes: candidate_not_found, candidate_flow_mismatch, candidate_not_editable, custom_variables_invalid, custom_variables_limit_exceeded, candidate_changed.</li>
<li>Reload get_flow_candidate before retrying candidate_changed.</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.