Skip to main content
POST
/
v1
/
agents
/
{agent_id}
/
gateway
/
conversations
/
{conversation_id}
/
answers
Submit Question Answers (Stream)
curl --request POST \
  --url https://api.xpander.ai/v1/agents/{agent_id}/gateway/conversations/{conversation_id}/answers \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "decision_id": "<string>",
  "answers": [
    {
      "question_id": "<string>",
      "selected_option_ids": [
        "<string>"
      ],
      "free_text": "<string>"
    }
  ],
  "user": {}
}
'
{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}
When a turn pauses with an ask_user_questions card, submit the structured answers here to resume. Answers are validated against the asked questions; a mismatch returns 400 before any run. Streams the resumed turn’s events over SSE. See the Agent Gateway overview for the full conversation model.

Authorizations

​
x-api-key
string
header
required

API Key for authentication

Path Parameters

​
agent_id
string
required
​
conversation_id
string
required

Query Parameters

​
version
string | null

Agent version to run.

Body

application/json

Body of the chat-backend answers endpoint.

​
decision_id
string
required

Id of the AskUserQuestions activity entry being answered.

​
answers
AskUserQuestionAnswer · object[]
required
​
user
User · object

Response

Successful Response