Skip to main content
GET
cURL

Authorizations

Authorization
string
header
default:dav_ak_live_your_token
required

Personal access token. The scopes granted at issuance determine both which operations the key may call and the ceiling on the resource permissions it can exercise. Each scope family is a ladder: projects:manage implies projects:write and projects:read; cards:manage implies cards:write and cards:read; and teams:manage implies teams:write and teams:read. These are named API capability bundles, not blanket domain roles: manage exposes only the permissions enumerated for that scope and never bypasses the acting user's current role-based access.

Path Parameters

projectId
string
required

Project id. May be compound in the form {projectId}--{branchName}.

Minimum string length: 1
sessionId
string<uuid>
required

Session id from createSession.

Query Parameters

limit
integer
default:100

Most recent entries to return.

Required range: 1 <= x <= 500

Response

The conversation.

sessionId
string<uuid>
required
taskId
string
required
source
enum<string>
required

Where the answer came from. live is current; persisted is the copy saved when a run ended, and so lags a run in progress.

Available options:
live,
persisted,
none
status
enum<string>
required
  • no_session — the machine has no record of this session; it lapsed or the project restarted. Create a new one.
  • project_not_running — the session is known but its project has unloaded.
  • idle — the session is live and no run has been started.
  • starting — a run is being set up.
  • running — a run is in progress.
  • paused — a run was stopped and can be continued with a new prompt.
  • completed — the run finished.
  • failed — the run ended in an error. The transcript says why.
  • unknown — the machine could not be reached for this field. Retry; anything else in the same response is still valid.

paused, completed, and failed are terminal for a run.

Available options:
no_session,
project_not_running,
idle,
starting,
running,
paused,
completed,
failed,
unknown
entryCount
integer
required

Entries in the whole conversation, not just the returned window.

Required range: x >= 0
messages
object[]
required

Oldest first. Bounded by limit, taken from the end.