Connect Compute Executor

POST

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

POST

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

curl -X POST https://api.sikaru.ai/v1/projects/project_id/compute-attachments/attachment_id/connect \
     -H "Authorization: Bearer <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "capabilities": [
    "compute.execute"
  ],
  "executor_instance_id": "string",
  "journal_id": "string",
  "protocol_version": "string",
  "workspace_provenance": {
    "identity": "string",
    "kind": "existing_directory"
  }
}'

{
  "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
}

Attest original workspace/journal. Reconnection never replays uncertain effects.

Authentication

AuthorizationBearer

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

Path parameters

project_idstringRequired

attachment_idstringRequired

Request

This endpoint expects an object.

capabilitieslist of enumsRequired

Optional features beyond compute.execute. ‘condition-waits-v1’ serves bash.wait_for (WaitForArguments -> WaitForResult) and jobs.next_completed (NextCompletedArguments -> NextCompletedResult); only executors declaring it receive those operations.

Allowed values:

executor_instance_idstringRequired1-128 characters

journal_idstringRequired1-128 characters

protocol_version"sikaru-compute-v1"Required

workspace_provenanceobjectRequired

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