Skip to main content

Update prompt variables

POST 
/api/v1/llm/update-prompt-variables

Agent Profiles: merges prompt variables into the thread for late-binding. The variables are re-rendered into the active profile's prompt on the next turn. Returns the merged conversation settings.

Prompt-variable update masks​

When you supply updateMask:

  • Masked keys are authoritative. A masked key whose value is null or absent clears that variable.
  • Unmasked keys are untouched. Variables not listed in the mask keep their current values, even if you include them in the payload.

Without updateMask:

  • Supplied keys overwrite or add.
  • Null or empty values clear the variable.
  • Keys you omit are not touched.

Request​

Responses​

Prompt variables merged

Document ID: DOC-MA-conversations-api-updatePromptVariables. Section identities and revisions.

SectionStable reference
OverviewDOC-MA-conversations-api-updatePromptVariables#overview
RequestDOC-MA-conversations-api-updatePromptVariables#request
ResponsesDOC-MA-conversations-api-updatePromptVariables#responses