Skip to main content
PUT
Report session sync progress

Authorizations

Authorization
string
header
required

Session JWT. After nasiko auth login, print it with jq -r '.clusters[.active].token' ~/.nasiko/config.json. API keys aren't supported.

Path Parameters

device_id
string
required

The reporting device: 1 to 64 characters of [A-Za-z0-9_-]

Body

application/json

The body a local client sends to PUT /api/me/coding-agents/sync/{device_id}.

agents
object[]
required
client
enum<string>
required
Available options:
desktop,
cli
device_name
string
required
phase
enum<string>
required

Where a device's run is. Clients no longer send awaiting_consent (consent is local to the client); it is still accepted so a report from an older client is not a 400.

Available options:
awaiting_consent,
discovering,
connecting,
importing,
sending,
done,
failed
error
string | null
windows
object[]

Read windows, newest first. Absent from v1 clients.

Response

The stored run

One device's latest run, as stored.

agents
object[]
required
client
enum<string>
required
Available options:
desktop,
cli
device_id
string
required
device_name
string
required
phase
enum<string>
required

Where a device's run is. Clients no longer send awaiting_consent (consent is local to the client); it is still accepted so a report from an older client is not a 400.

Available options:
awaiting_consent,
discovering,
connecting,
importing,
sending,
done,
failed
updated_at
string<date-time>
required
windows
object[]
required
error
string | null
retry_requested_at
string<date-time> | null

When the user last asked this device to re-send its quarantined turns; null if never.

started_at
string<date-time> | null

When the current run entered discovering; null if this device never started one.