Start Managed Harness Run

POST

https://api.sikaru.ai/v1/projects/:project_id/harnesses/:harness_id/runs

POST

/v1/projects/:project_id/harnesses/:harness_id/runs

curl -X POST https://api.sikaru.ai/v1/projects/project_id/harnesses/harness_id/runs \
     -H "Authorization: Bearer <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "input": {},
  "policy": {},
  "product_context": {},
  "tenant_id": "string",
  "user_id": "string"
}'

{
  "eventsUrl": "string",
  "harnessId": "string",
  "harnessVersionId": "string",
  "runId": "string",
  "status": "string",
  "compatibilityProfileId": "string",
  "completedAt": "string",
  "connections": [
    {
      "display_name": "string",
      "id": "string",
      "kind": "string"
    }
  ],
  "contentVisible": true,
  "costSummary": {},
  "error": {
    "code": "string",
    "message": "string",
    "recoverable": true,
    "stage": "admission"
  },
  "latencyMs": 1.1,
  "personal": true,
  "usageSummary": {}
}

Authentication

AuthorizationBearer

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

Path parameters

project_idstringRequired

harness_idstringRequired

Request

This endpoint expects an object.

inputmap from strings to anyRequired

policymap from strings to anyRequired

product_contextmap from strings to anyRequired

tenant_idstringRequired

user_idstringRequired

auto_improvebooleanOptionalDefaults to false

Automatically request evaluated harness improvements after completed turns. Requires harness:write and configured improvement policy; active runs keep their pinned release.

capability_grantslist of stringsOptionalDefaults to []

compute_environment_idstring or nullOptional1-128 characters

compute_workspace_provenanceobject or nullOptional

conversation_idstring or nullOptional

correlation_idstring or nullOptional

event_deliveryobjectOptional

idempotency_keystring or nullOptional1-128 characters

job_idstring or nullOptional

modelstring or nullOptional1-256 characters

Catalog model for this run. Omit to use the project default; list choices through model settings.

run_modeenumOptionalDefaults to interactive

Allowed values:

tool_provider_refslist of objectsOptionalDefaults to []

trace_idstring or nullOptional

Response

Successful Response

eventsUrlstring

harnessIdstring

harnessVersionIdstring

runIdstring

statusstring

compatibilityProfileIdstring or nullOptional

completedAtstring or nullOptional

connectionslist of objectsOptional

contentVisiblebooleanOptional

costSummarymap from strings to any or nullOptional

errorobject or nullOptional

Why the run failed; set when status is failed, otherwise null. Omitted when contentVisible is false.

latencyMsdouble or nullOptional

personalbooleanOptional

usageSummarymap from strings to any or nullOptional

Errors

401

Unauthorized Error

402

Payment Required Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

422

Unprocessable Entity Error

429

Too Many Requests Error

503

Service Unavailable Error