Skip to main content
PUT
Report a terminal chat's prompt

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

computerID
string<uuid>
required
Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
sessionID
string<uuid>
required
Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
promptID
string<uuid>
required
Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$

Body

application/json
hold_seconds
integer
required

How long from now the bridge holds the hook open, in seconds: the prompt expires then.

Required range: 1 <= x <= 7200
input_shortened
boolean
required

The bridge cut the input's longest strings to fit it in 64 KiB.

kind
enum<string>
required

permission asks to run a tool call, answerable from Aether; question asks in the terminal alone (AskUserQuestion, ExitPlanMode), or, a run's, from Aether alone.

Available options:
permission,
question
tool_input
object
required

The tool call's input, as Claude Code asked to run it: at most 64 KiB as Postgres stores it, each key once.

tool_name
string
required

The Claude Code tool the prompt is about: Bash, Edit, an MCP tool.

Required string length: 1 - 200
decisions
object[]

permission only: what the request offers beside allow and deny, which every permission request offers, from what the agent itself suggested. Absent when it offers nothing else. Each adds, for the agent's session alone, allow rules the agent suggested for the request's own tool; the bridge names no change of mode, no folder and no write to a settings file. A report naming anything else, an id twice, an id allow or deny, or rules whose text holds a link, an address or a domain or runs over 200 characters, is refused whole with 422 prompt_decisions_refused.

Required array length: 1 - 8 elements
run_id
string<uuid>

The run whose hooks reported the prompt (reportTerminalChatRun's delivery_id): no terminal answers it, so Aether shows a question of it as answerable too. Absent for a terminal's.

Response

OK

chat_id
string<uuid>
required
expires_at
string<date-time>
required
id
string<uuid>
required
input_shortened
boolean
required
kind
enum<string>
required
Available options:
permission,
question
requested_at
string<date-time>
required
state
object
required

Waiting on the person, in Aether and in the terminal; a run's, in Aether alone.

tool_input
object
required

The tool call's input, as Claude Code asked to run it: at most 64 KiB as Postgres stores it, each key once.

tool_name
string
required

The Claude Code tool the prompt is about: Bash, Edit, an MCP tool.

Required string length: 1 - 200