API referenceEndpoints

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.

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

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.

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

curl -X POST "https://example.com/v1/runner/blinqs/runs/497f6eca-6276-4993-bfeb-53cbbbba6f08/model" \  -H "Content-Type: application/json" \  -d '{    "model": "string",    "messages": [      {        "role": "system"      }    ],    "max_output_tokens": 1  }'
{  "model": "string",  "message": {    "role": "system",    "tool_call_id": "string",    "tool_calls": [      {        "id": "string",        "type": "function",        "function": {          "name": "string",          "arguments": "string"        }      }    ],    "content": "string"  },  "finish_reason": "string",  "input_tokens": 0,  "output_tokens": 0,  "request_id": "string"}

Pair a Blinq server

Requires a Blinq service pairing secret in the Authorization bearer header; no tenant authentication is used. Generated from the production route registered in `internal/features/runners/inbound/http.go`. Bootstrap with the service's nonexpiring dlrt_ secret in Authorization: Bearer, not a tenant or server credential. The Engine rechecks the secret and service under transaction locks and commits the new server with its audit record. The response returns a shown-once dlba_ server credential with Cache-Control: no-store. Ordinary runner registration tokens are refused. Pairing does not announce a version or enable Blinq work; Blinq servers cannot claim or settle ordinary runner tasks.

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.