Skip to main content
GET
Read a message sent to a task

Authorizations

Authorization
string
header
required

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

Path Parameters

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

Response

OK

Aether holds the message, and it can be taken back.

attachments
object[]
required
created_at
string<date-time>
required
expires_at
string<date-time> | null
required

When Aether stops holding the message, which then reads not_delivered with hold_expired; null in a cloud sandbox.

id
string
required

A task message's id: a uuid for a message the API queued or a chat forked inside its task copied, or a key derived from the message's source (an assistant message, a seam, a message replayed from an imported session).

Pattern: ^(?:[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}|message:[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}:(?:text|thinking):[0-9a-f]{64}|implicit:[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}:(?:text|thinking):[0-9]+|seam:compaction:[^:]+:[^:]+|seam:teleport:\S(?:[\s\S]*\S)?|teleport:\S(?:[\s\S]*\S)?:[0-9]{6,})$
kind
enum<string>
required
Available options:
user
sequence
null
required

Null: the conversation does not show the message.

state
enum<string>
required
Available options:
queued
text
string
required
turn_id
null
required

Null: the conversation does not show the message.

waiting
object
required

Why the message has not left Aether. turn_running: its chat's turn runs. other_chat_turn: another chat's turn runs, which waits_for names. earlier_message: an earlier message of its chat is on its way. computer_unreachable: its computer cannot be reached. chat_being_forked: its chat's work is being handed to a fork. open_in_terminal, agent_starts_off, agent_limit, chat_busy, not_signed_in, agent_not_installed: the computer holds its run back for that reason.

client_message_id
string<uuid>
message_event
object
sender
object
tool_response
object
waits_for
object

The turn another chat of the task runs while the message waits: one turn runs at a time per workspace. Present exactly when waiting's code is other_chat_turn.