BilbyHelp Center

Answer pending questions

POST
/api/v1/conversations/{id}/tool-outputs

Answer pending client-side question tool calls and resume the agent.

Body is { outputs: [{ toolCallId, output }] } where output matches { status: 'answered' | 'dismissed', answers: [{ question, selected, custom? }], summary }. Discover pending calls via GET /conversations/:id (pendingQuestions) or SSE tool-input-available events. Returns 202 like Send message. Returns 404 for unknown/already-answered calls, 409 when a turn is in flight.

Authorization

bearerAuth
headerAuthorizationBearer <token>

Personal API key (Authorization: Bearer pulse_...). Scoped to selected organizations (or all current ones); acts as the creating user. If the key covers more than one organization, pass its organizationId on each request.

Path Parameters

id*string

Query Parameters

organizationId?string

Organization to operate in. Optional when the API key is bound to exactly one organization (inferred). Required for keys that cover several or all organizations, and for session cookie auth.

Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid
workspaceId?stringDeprecated

Deprecated: the old name of organizationId, still accepted. If both are sent, they must match.

Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid
runId?string
cursor?string

Request Body

application/json
  1. body
outputs*array<>
Items1 <= items
locale?string
reasoningEffort?string
Value in"auto""low""medium""high""max"

Response Body

Answers accepted, continuation turn admitted

application/json
  1. response
ok*boolean
conversationId*string
Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid
status*string
runId*string
streamUrl*string
Example Request
curl -X POST 'https://pulse.bilby.ai/api/v1/conversations/string/tool-outputs' \  -H 'Authorization: Bearer YOUR_API_KEY' \  -H 'Content-Type: application/json' \  -d '{  "outputs": [    {      "toolCallId": "string",      "output": {        "status": "answered",        "answers": [          {            "question": "string",            "selected": [              "string"            ]          }        ],        "summary": "string"      }    }  ]}'
Example Response
{  "ok": true,  "conversationId": "ee6e55e8-45fe-4a3e-9bc8-4669f9fdf77a",  "status": "accepted",  "runId": "string",  "streamUrl": "string"}