API referenceEndpoints

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.

GET/v1/runner/blinqs/runs/{id}/threads/{thread_id}

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.

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
thread_id*string
Formatuuid

Query Parameters

after?integer

Return messages with sequence greater than this cursor; use messages.next_after for another page.

Formatint64
Range0 <= value
Default0

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/runner/blinqs/runs/497f6eca-6276-4993-bfeb-53cbbbba6f08/threads/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{  "thread": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "title": "string",    "agent_id": "2b1e3b65-2c04-4fa2-a2d7-467901e98978",    "run_id": "dded282c-8ebd-44cf-8ba5-9a234973d1ec",    "read_through_seq": 0,    "last_seq": 0,    "unread_count": 0,    "created_at": "2019-08-24T14:15:22Z",    "updated_at": "2019-08-24T14:15:22Z"  },  "messages": {    "data": [      {        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",        "thread_id": "1de43264-67cb-48af-89f9-e865c375bb84",        "seq": 1,        "sender": "agent",        "agent_id": "2b1e3b65-2c04-4fa2-a2d7-467901e98978",        "run_id": "dded282c-8ebd-44cf-8ba5-9a234973d1ec",        "body": "string",        "needs_answer": true,        "reply_to_id": "10173927-18c3-4735-9cde-0eab0dfa563b",        "answer_id": "8bde0c5f-235e-41e6-bf82-b73e92852ac8",        "created_at": "2019-08-24T14:15:22Z"      }    ],    "next_after": 1  }}

Call a governed model under a live Blinq claim

undefined Generated from the production route registered in `internal/features/runners/inbound/http.go`. Requires the paired server bearer AND its live X-Blinq-Claim-Authority. Stored run identity determines organization, owner, application, pricing and account. Current active bound ownership is checked before preparation, reservation and provider dispatch; membership loss cancels the run and returns blinq_owner_inactive. Identity locks precede hire/run locks. Request body at most128KiB; no identity, credentials, streaming flag or tool declarations. Existing governed chat/Bifrost prepares and screens text/JSON completion, reserves existing credit/user caps and plan allowance, and charges reported usage to the run owner. Durable per-run reservations enforce frozen manifest limits intersected with current approval. Provider-only authority locking and lease/deadline cancellation preserve revocation without taking billing locks under hire locks. Definite pre-dispatch refusal refunds; uncertain dispatched work remains conservatively reserved. Only model calls check budgets; a refused model call does not block free context, progress, notification or state commits. Budget refusal code model_budget_exhausted, run ceiling blinq_run_limit, unknown plan plan_unknown and guardrails guardrail_blocked are distinct. Responses are not cacheable. Ordinary gateway routes remain closed to runner credentials.

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.