Skip to content
Everruns Cloud is open in early access. Run agents without operating the platform.

POST /v1/sessions/{session_id}/question-answers

POST
/v1/sessions/{session_id}/question-answers
curl --request POST \
--url https://app.everruns.com/api/v1/sessions/example/question-answers \
--header 'Content-Type: application/json' \
--data '{ "answers": [ { "id": "target", "other_text": null, "selected": [ "Staging" ] } ], "status": "answered", "tool_call_id": "toolu_01933b5a00007000800000000000001" }'

Answers the question set an agent raised with ask_user, and resumes the paused turn.

session_id
required
string

Session ID (prefixed, e.g., session_…)

Media typeapplication/json

Request to answer a pending ask_user question set.

object
answers

One answer per asked question, keyed by question id.

Array<object>

One submitted answer.

object
id
required

Question id, as carried in the tool.call_requested payload.

string
other_text

Free text, accepted only when the question allows it.

string | null
selected

Chosen option labels. Must be labels that were actually offered.

Array<string>
Example
[
{
"id": "target",
"other_text": null,
"selected": [
"Staging"
]
}
]
status

What the person did. answered carries answers; declined is a finished decision the model must not re-ask.

string
Allowed values: answered declined
tool_call_id

The ask_user tool call being answered. Optional: when omitted the one pending question set on the session is used.

string | null
Example
toolu_01933b5a00007000800000000000001

Answer recorded and workflow resumed

Media typeapplication/json

Result of answering a pending question set.

object
answered_by
required

Who the server attributed the outcome to.

string
session_status
required

Session status after the answer.

string
status
required

Outcome recorded against the call.

string
Example
{
"answered_by": "user",
"session_status": "active",
"status": "answered"
}

Invalid session ID, or answers that do not match what was asked

Session or pending question set not found

Session is not waiting for tool results, or the question set was already answered

Internal server error