Skip to main content
PUT
Ship a range of a terminal chat's session file

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}$
file
string
required
Pattern: ^(session|agent-[A-Za-z0-9_-]{1,64})$

Body

application/json
bytes
string
required

The range's bytes, 1 byte to 4 MiB, in standard base64 with its padding.

Required string length: 1 - 5592408
Pattern: ^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$
generation
integer<int64>
required

The generation the range is of: the file's current one, or from offset 0 the one after it, which replaces the file.

Required range: x >= 1
offset
integer<int64>
required

The byte offset of the range's first byte in the file.

Required range: x >= 0

Response

OK

file
string
required

session, the session file, or agent-, a sub-agent's file Claude Code writes beside it.

Pattern: ^(session|agent-[A-Za-z0-9_-]{1,64})$
generation
integer<int64>
required

The generation of the file Aether holds: 0 while it holds nothing, one higher each time the file was replaced.

Required range: x >= 0
size
integer<int64>
required

How many bytes of the generation Aether holds, from offset 0.

Required range: x >= 0
tail_sha256
string
required

The lowercase hex SHA-256 of the last 64 bytes Aether holds (all of them when it holds fewer).

Pattern: ^[0-9a-f]{64}$
turn_running
boolean
required

Whether the chat runs a turn once Aether took the range in: false once the chat is idle, as the range itself may have ended its turn. A range sent again answers as the chat stands when it arrives.