Skip to main content
POST
Heartbeat worker

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

Response

Refreshes the liveness timestamp for an existing agent worker after verifying project access.

worker
object
required
token
string | null

Worker credential (vfaw_...), returned once on registration and null or absent otherwise. Store it as a secret and send it as Authorization: Bearer (agentWorkerAuth) on this worker's heartbeat, claim, lease renewal and session operations.