Extend a work lease

⚠️
Preview — this feature is being built; the design below is the spec.
POST https://app.syntic.ai/v1/runners/work/{work_id}/heartbeat

Extend the lease on a work item by another 60 seconds while a long tool call is still running. Optionally stream partial output so the agent’s event log shows progress.

For how this fits into a full workflow, see Self-hosted runners.

Headers

HeaderRequiredValue
AuthorizationYesBearer <runner token>: a self-hosted runner token (srt_...) issued when the runner was registered. Inference and admin keys are refused. See Self-hosted runners.
syntic-betaYes, while in previewagents-2026-11-01. Without it the call fails with 400 beta_required. See Versioning.
Content-TypeYesapplication/json

Path parameters

ParameterTypeDescription
work_idstringThe work item id, starting with work_.

Body parameters

ParameterTypeRequiredNotes
progressstringNoUp to 4 KB of new output since the last heartbeat. Shown as tool_call.progress events in the session stream.

Response

200 OK, Content-Type: application/json

{
  "id": "work_01JCD3F5H7K9M1P3R5T7",
  "lease_expires_at": "2026-11-05T10:02:41Z",
  "cancel_requested": false
}
FieldTypeDescription
lease_expires_atstringThe new deadline.
cancel_requestedbooleantrue when the session was interrupted; stop the work and call release.

Examples

curl -sS "https://app.syntic.ai/v1/runners/work/work_01JCD3F5H7K9M1P3R5T7/heartbeat" \
  -H "Authorization: Bearer $SYNTIC_RUNNER_TOKEN" \
  -H "syntic-beta: agents-2026-11-01" \
  -H "Content-Type: application/json" \
  -d '{
      "progress": "Matched 1,840 of 2,212 invoices…"
    }'

Errors

Errors use the error envelope and carry a request_id. Codes specific to this operation:

StatustypecodeWhen
400invalid_request_errorbeta_requiredThe syntic-beta header is missing.
409conflict_errorlease_lostThe lease already expired and the item went back to the queue.
404not_found_errorwork_not_foundNo work item with this id leased to this runner.
429rate_limit_errorrate_limitedToo many requests; wait for Retry-After. See Rate-limit headers.
Was this page helpful?