v6

latestOpenAPI 3.0.1raw.githubusercontent.com2026-08-0182128753.1 KB

Conversations

Update Conversation Variable

Available for: Chatflow, Chatbot, Agent apps.

Updates a conversation variable's value. The new value must match the variable's existing type.

put/conversations/{conversation_id}/variables/{variable_id}

Path parameters

conversation_idstring uuid required

ID of the conversation that owns the variable. Get conversation IDs from List Conversations.

variable_idstring uuid required

ID of the variable to update. Get variable IDs from List Conversation Variables.

Request body

{"stackTrail":"components:schemas:ConversationVariableUpdateRequest:properties:value","oasType":"schema","type":"unknown","description":"The new value for the variable. Must match the variable's expected type."}

userstring

End-user identifier, defined by your app and unique within it. See End User Identity.

Response

Variable updated successfully.

idstring uuid

Variable ID.

namestring

Variable name.

value_typestring

Variable value type. Possible values: string, number, object, secret, file, boolean, array[any], array[string], array[number], array[object], array[file], array[boolean].

valuestring

Variable value (can be a JSON string for complex types).

descriptionstring

Variable description.

created_atinteger

Creation timestamp.

updated_atinteger

Last update timestamp.