Skip to main content
POST
Update Studio presence

Authorizations

Authorization
string
header
required

Bearer JWT token or API Key (sk-*).

Path Parameters

sessionId
string
required

Body

application/json
operationId
string<uuid>
required

Caller-generated UUID idempotency key for this exact operation.

connectionId
string<uuid>

The current server-owned connectionId received on Studio websocket JOIN. With this ID, activity updates only this active connection. Without it, activity uses a separate actor-scoped 180-second headless lease.

studioActorId
string<uuid>
activeFileId
string<uuid> | null
openedFileIds
string<uuid>[]
Maximum array length: 100
editingFileIds
string<uuid>[]

Last-reported files with unsaved editor changes. Advisory activity only; no buffer content, exclusive lock or additional authority.

Maximum array length: 100

Response

201