API referenceEndpoints

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.

POST/v1/runner/blinqs/runs/{id}/tools/read

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.

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.

Response Body

application/json

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/tools/read" \  -H "Content-Type: application/json" \  -d '{    "tool": "calendar.list",    "arguments": {}  }'
{}

Read a live Blinq claim's own Inbox thread

undefined Generated from the production route registered in `internal/features/runners/inbound/http.go`. Requires both the paired server bearer and its live claim's X-Blinq-Claim-Authority. Stored claim identity, never caller identity fields, binds the run, organization, owner and agent. Current own_threads approval, active hire, active bound owner identity and unexpired lease/deadline are required under revocation/identity/hire/run locks. Owner access loss cancels the run and returns blinq_owner_inactive. Credits and model budgets do not block this context read. Other threads return not found; stale, replaced, ended or revoked claims are refused. Returns at most 100 messages, with messages.next_after when another page exists. Does not mark the thread read. Response is not cacheable.

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.