Sync Agent Session

Sync a Claude Code transcript from a developer laptop. Requires a user token (device-flow `agent login`): the user is part of the sync's idempotency key, so API keys and sandbox tokens are rejected with a 403 rather than silently attributed.

Sync a Claude Code transcript from a developer laptop.

Requires a user token (device-flow agent login): the user is part of the sync's idempotency key, so API keys and sandbox tokens are rejected with a 403 rather than silently attributed.

Authorization

HTTPBearer

AuthorizationBearer <token>

In: header

Header Parameters

user-agent?string|null

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

One hook-driven transcript sync from a developer laptop. The CLI reads the live on-disk Claude Code transcript, redacts it client-side, gzips it, and POSTs it here — once per turn and at termination.

cc_session_id*Cc Session Id

The Claude Code session uuid (from the hook payload's session_id).

cwd?|

The laptop working directory.

git_branch?|

The checked-out git branch.

reason?Reason

Which hook fired the sync: "stop" (mid-session, once per turn) or "session_end" (the Claude Code process terminated).

Default"stop"

Value in

"stop"
"session_end"

repo?|

The enrolled repository ("owner/name", from the working directory's git remote).

transcript_gzip_b64*Transcript Gzip B64

The redacted transcript JSONL, gzipped then base64-encoded.

Response Body

`application/json`

curl -X POST "https://example.com/v1/sessions/sync" \  -H "Content-Type: application/json" \  -d '{    "cc_session_id": "string",    "transcript_gzip_b64": "string"  }'

{  "accepted": true,  "event_count": 0,  "process_id": "string",  "session_id": "string"}

Authorization

Header Parameters

Request Body

Response Body

200application/json

422application/json

`application/json`

`application/json`