Skip to main content
POST
Answer a question or approval

Authorizations

Authorization
string
header
required

An org API key (gh_live_…) from Settings → API keys in the console.

Path Parameters

task_id
string
required

The task’s id.

Body

application/json
question_id
string
required
answer
string
required
Maximum string length: 4000

Response

OK

object
any
task_id
string
session_id
string
agent_id
string
status
enum<string>
Available options:
queued,
running,
waiting_for_user,
waiting_for_approval,
completed,
failed,
stopped
done
boolean
prompt
string
result
string | null

The agent’s summary when it finished.

error
string | null
pending
Question · object

What the agent waits on: answer it with /respond.

cursor
integer

The latest event’s cursor.

metadata
object

Your own ids and labels (e.g. a ticket or customer id), returned as given.

Example:
created_at
string<date-time>
updated_at
string<date-time>
active_seconds
integer

Time spent running (not waiting on a person).

billed_minutes
integer | null
replay_url
string

The replay in the console.

recording
object
events
object[]

With include=events.