Skip to content
tcpsystems
Version: Current

GET and PUT /v1/route/measures

Part of the API reference; this page is generated from the OpenAPI document that the gateway builds from its own route tables.

Provenance

Section titled “Provenance”
  • Contract version: 1.10.0
  • Contract title: acumen gateway API
  • Source: acumen:docs/openapi/acumen-v1.openapi.json

Operations

Section titled “Operations”

GET /v1/route/measures

Section titled “GET /v1/route/measures”

List resolver measures

Measured quality and tool-call fidelity observations with sample counts and observation times. Operator (ops:read) scope.

  • Operation id: getV1RouteMeasures
  • Scope: ops:read
  • Exposure: operator
  • Mutating: no
  • Auth: bearerAuth, operatorSession

Responses

  • 200: OK
    • application/json: RouteMeasureList: RouteMeasureList (object)
  • 400: schema_invalid — the request body or parameter failed validation
    • application/problem+json: Problem: Problem (object)
  • 401: auth_missing — no virtual key or operator session
    • application/problem+json: Problem: Problem (object)
  • 403: auth_scope — the credential lacks the route’s scope
    • application/problem+json: Problem: Problem (object)
  • 404: resource_not_found — the addressed object does not exist
    • application/problem+json: Problem: Problem (object)
  • 405: method_not_allowed — the path exists for another verb
    • application/problem+json: Problem: Problem (object)
  • 429: rate_limited — the per-key or per-IP bucket is exhausted
    • application/problem+json: Problem: Problem (object)
  • 500: internal — the store or process failed
    • application/problem+json: Problem: Problem (object)
  • 501: not_implemented — the route is declared but not wired in this build
    • application/problem+json: Problem: Problem (object)
  • 503: store_unavailable — the dependency is down; retryable
    • application/problem+json: Problem: Problem (object)

PUT /v1/route/measures

Section titled “PUT /v1/route/measures”

Write resolver measures

Upserts 1 to 500 measures keyed by (dimension, subject, source). score is within [0,1]; n is the sample count behind it and sets the confidence. Operator (admin) scope.

  • Operation id: putV1RouteMeasures
  • Scope: admin
  • Exposure: operator
  • Mutating: yes
  • Auth: bearerAuth, operatorSession

Request

  • Request body (application/json, required): RouteMeasureWrite: RouteMeasureWrite (object)
Field Type Required Notes
measures array of RouteMeasure (object) yes

Responses

  • 200: OK
    • application/json: RouteMeasureWritten: RouteMeasureWritten (object)
  • 400: schema_invalid — the request body or parameter failed validation
    • application/problem+json: Problem: Problem (object)
  • 401: auth_missing — no virtual key or operator session
    • application/problem+json: Problem: Problem (object)
  • 403: auth_scope — the credential lacks the route’s scope
    • application/problem+json: Problem: Problem (object)
  • 404: resource_not_found — the addressed object does not exist
    • application/problem+json: Problem: Problem (object)
  • 405: method_not_allowed — the path exists for another verb
    • application/problem+json: Problem: Problem (object)
  • 429: rate_limited — the per-key or per-IP bucket is exhausted
    • application/problem+json: Problem: Problem (object)
  • 500: internal — the store or process failed
    • application/problem+json: Problem: Problem (object)
  • 501: not_implemented — the route is declared but not wired in this build
    • application/problem+json: Problem: Problem (object)
  • 503: store_unavailable — the dependency is down; retryable
    • application/problem+json: Problem: Problem (object)