Skip to main content
PUT
Update worker run session

Authorizations

Authorization
string
header
required

The token returned by createAgentWorker, sent as Authorization: Bearer vfaw_... (or X-API-Key). It is bound to one worker and only accepted on that worker's heartbeat, claim, lease renewal and session operations.

Path Parameters

worker_id
string<uuid>
required
run_id
string
required
Required string length: 1 - 128

Body

application/json
session_key
string
required
Required string length: 1 - 512
status
enum<string>
Available options:
active,
completed,
failed,
cancelled
metadata
object | null

Response

Worker session metadata created or updated for the worker-owned run.

session
object
required