API referenceEndpoints

Commit progress under a live Blinq claim

undefined Generated from the production route registered in `internal/features/runners/inbound/http.go`. Requires assigned server bearer AND live X-Blinq-Claim-Authority. Generation and expected checkpoint revision fence one atomic checkpoint/receipt/audit commit under revocation/hire/run locks. Continue increments revision, retains claim/generation/lease and acknowledges identical receipt replay only while the claim is live. Different content for a recorded identity conflicts. Finish/fail terminate run/task and clear authority; terminal, expired, replaced and revoked workers are refused, including terminal retries. Fail stores workflow_failed on the run and its bounded category on the task. Current bound owner membership is rechecked under shared identity locks before hire/run locks. Removed owners get403 blinq_owner_inactive after their run/task cancellation and authority invalidation commit with audit. Credits and budgets are not checked, so free effects and previously paid saved text still deliver when credits run out. Typed notify and revision-checked set_state commit with the checkpoint and audit. Once-key receipts suppress duplicate delivery across runs and report already_delivered. Stale state rolls everything back. Expiry during a commit also rolls it back. Ask/approve remain unsupported. Response is not cacheable.

POST/v1/runner/blinqs/runs/{id}/transitions

undefined Generated from the production route registered in internal/features/runners/inbound/http.go. Requires assigned server bearer AND live X-Blinq-Claim-Authority. Generation and expected checkpoint revision fence one atomic checkpoint/receipt/audit commit under revocation/hire/run locks. Continue increments revision, retains claim/generation/lease and acknowledges identical receipt replay only while the claim is live. Different content for a recorded identity conflicts. Finish/fail terminate run/task and clear authority; terminal, expired, replaced and revoked workers are refused, including terminal retries. Fail stores workflow_failed on the run and its bounded category on the task. Current bound owner membership is rechecked under shared identity locks before hire/run locks. Removed owners get403 blinq_owner_inactive after their run/task cancellation and authority invalidation commit with audit. Credits and budgets are not checked, so free effects and previously paid saved text still deliver when credits run out. Typed notify and revision-checked set_state commit with the checkpoint and audit. Once-key receipts suppress duplicate delivery across runs and report already_delivered. Stale state rolls everything back. Expiry during a commit also rolls it back. Ask/approve remain unsupported. Response is not cacheable.

Authorization

blinqServerCredential blinqClaimAuthority
AuthorizationBearer <token>

Credential issued to one paired Blinq server. Its prefix must match its stored node kind; its node, pairing secret and service must remain active. It conveys no tenant identity and stays inside the runner route fence. Neither a dlrt_ service secret nor an ordinary dlra_ runner credential substitutes for it.

In: header

X-Blinq-Claim-Authority<token>

Shown-once dlbc_ per-claim secret. Required together with the assigned server bearer; neither credential substitutes for the other. Ends with lease/deadline, terminal state, takeover or revocation.

In: header

Path Parameters

id*string
Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

At most128KiB request. Generation/revision are Engine-owned identities. Ask/approve remain unsupported. Up to eight typed effects; stale state or an unauthorized effect rolls back the whole transition.

At most128KiB request. Generation/revision are Engine-owned identities. Ask/approve remain unsupported. Up to eight typed effects; stale state or an unauthorized effect rolls back the whole transition.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/runner/blinqs/runs/497f6eca-6276-4993-bfeb-53cbbbba6f08/transitions" \  -H "Content-Type: application/json" \  -d '{    "claim_generation": 1,    "expected_revision": 0,    "kind": "continue",    "checkpoint": null  }'
{  "effects": [    {      "kind": "notify",      "ordinal": 0,      "outcome": "delivered",      "thread_id": "1de43264-67cb-48af-89f9-e865c375bb84",      "message_id": "d7d9d9fd-478f-40e6-b651-49b7f19878a2"    }  ],  "run_id": "dded282c-8ebd-44cf-8ba5-9a234973d1ec",  "claim_generation": 1,  "checkpoint_revision": 1,  "status": "running",  "replayed": true}

Read a connected tool for the current hire

undefined Generated from the production route registered in `internal/features/runners/inbound/http.go`. The Engine resolves the current owner's selected account for an approved read. Missing access returns 409 blinq_tool_access_required.

Claim a Blinq step

Requires the paired Blinq server's credential in the Authorization bearer header; tenant and administrator credentials do not grant this authority. Generated from the production route registered in `internal/features/runners/inbound/http.go`. Long-polls for up to 20 seconds for one eligible queued step. Requires a live paired Blinq server credential; the service, secret and node are rechecked on every poll. The Blinq must be in both the node's fixed issued scope and its current hosting service, and this server must have announced the run's accepted version. Only active personally owned external hires with an unexpired run and a current active bound owner identity qualify. Identity cutoffs/bindings are checked against the original hire, so a later automatic admission cannot renew removed access. Ineligible-owner queued runs are canceled with audit and receive no claim. Credits and model budgets do not affect assignment. Assignment, generation increment and audit commit together; competing servers cannot receive the same step. Returns 204 when no eligible step is found. The response includes the shown-once per-claim execution_authority, bound to this server, organization, owner, hire and run; it must accompany the server credential on context/model/transition requests.