Skip to main content
GET
Read an agent session

Authorizations

Authorization
string
header
required

Permanent personal API key created in the dashboard. Example: curl -H "Authorization: Bearer aty_…" https://your-host/v1/projects

Path Parameters

sessionId
string
required

Session UUID returned by agent admission.

Minimum string length: 1

Query Parameters

limit
integer
default:50

Maximum turns to return. Each turn produces one user message and one assistant message.

Required range: 1 <= x <= 100
cursor
string

Opaque cursor for loading turns older than the current page.

Maximum string length: 500

Response

The restored agent session.

sessionId
string<uuid>
required
title
string
required
Maximum string length: 80
latestMessagePreview
string
required
Maximum string length: 240
lastRunId
string<uuid>
required
runCount
integer
required
Required range: x >= 1
createdAt
integer
required

Unix timestamp in milliseconds.

Required range: x >= 0
updatedAt
integer
required

Unix timestamp in milliseconds.

Required range: x >= 0
messages
object[]
required
Maximum array length: 200
nextCursor
string | null
required