Skip to main content
PATCH
Close 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
outcome
enum<string>
required

answered_from_aether: Aether's answer reached the hook. answered_in_terminal: the terminal answered first and the hook returned no decision. stopped: a stop from Aether reached the hook first, which denied the call and stopped Claude. expired: the hold ended first and the hook answered no decision, or, for a run's prompt, which no terminal holds, denied it.

Available options:
answered_from_aether,
answered_in_terminal,
stopped,
expired

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