Heartbeat Compute Executor

POST

https://api.sikaru.ai/v1/projects/:project_id/compute-attachments/:attachment_id/heartbeat

POST

/v1/projects/:project_id/compute-attachments/:attachment_id/heartbeat

curl -X POST https://api.sikaru.ai/v1/projects/project_id/compute-attachments/attachment_id/heartbeat \
     -H "Authorization: Bearer <apiKey>"

{
  "capabilities": [
    "string"
  ],
  "cleanup_at": 1.1,
  "cleanup_status": "unconfirmed",
  "environment_id": "string",
  "id": "string",
  "journal_id": "string",
  "lease_until": 1.1,
  "owner_epoch": 1,
  "owner_id": "string",
  "processes": [
    {
      "evidence": "string",
      "handle_id": "string",
      "status": "running"
    }
  ],
  "project_id": "string",
  "protocol_version": "string",
  "provider_id": "string",
  "session_id": "string",
  "startup_deadline": 1.1,
  "status": "pending",
  "uncertain_operations": [
    {
      "method": "string",
      "owner_epoch": 1,
      "request_digest": "string",
      "run_id": "string",
      "tool_call_id": "string",
      "workspace_generation": "string"
    }
  ],
  "workspace_generation": "string",
  "workspace_provenance": {
    "identity": "string",
    "kind": "existing_directory"
  },
  "lease_ttl_seconds": 60
}

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

project_idstringRequired

attachment_idstringRequired

Response

Successful Response

capabilitieslist of strings

cleanup_atdouble or null

cleanup_statusenum

Allowed values:

environment_idstring

idstring

journal_idstring

lease_untildouble

owner_epochinteger

owner_idstring or null

processeslist of objects

project_idstring

protocol_versionstring or null

provider_idstring

session_idstring

startup_deadlinedouble

statusenum

uncertain_operationslist of objects

workspace_generationstring

workspace_provenanceobject

lease_ttl_secondsintegerOptionalDefaults to 60

Renewal TTL; anchor only ready/heartbeat acknowledgments to request-start monotonic time. Status and poll responses never renew the lease.

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

422

Unprocessable Entity Error

503

Service Unavailable Error