Overview
POST/processing/jobs/{id}/heartbeatprocessing

Extend the lease on a claimed job

Workers call this periodically while processing a slow job to prevent the reaper from reclaiming it. Returns 404 when the lease guard fails.

Auth: bearerAuth — calls run as the authenticated user.

Parameters
  • idpathstring
Request body

application/json · optional

  • leaseTokenstring

    Opaque lease token returned by /claim

  • leaseMsoptionalinteger

    New lease duration in ms (default 30 000)

Example
{
  "leaseToken": "string",
  "leaseMs": 0
}
Responses
200

Extended lease expiry

  • leaseExpiresAtstring

    New lease expiry timestamp

Example
{
  "leaseExpiresAt": "string"
}
400

Error

  • erroroptionalobject
Example
{
  "error": {
    "message": "string",
    "code": "string"
  }
}
401

Error

  • erroroptionalobject
Example
{
  "error": {
    "message": "string",
    "code": "string"
  }
}
404

Error

  • erroroptionalobject
Example
{
  "error": {
    "message": "string",
    "code": "string"
  }
}
Code examples
cURL
curl -X POST "https://api.agenticdeveloperhub.com/processing/jobs/{id}/heartbeat" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "leaseToken": "string",
  "leaseMs": 0
}'
JavaScript
const res = await fetch("https://api.agenticdeveloperhub.com/processing/jobs/{id}/heartbeat", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"leaseToken\": \"string\",\n  \"leaseMs\": 0\n}",
});
const data = await res.json();