generated: '2026-10-19'
method: derived
generator: derive-vocabulary.py
source: openapi/_ae-authored/zespan-openapi-generated.yml
vocabulary:
  name: Zespan Domain Vocabulary
  description: 'Terms declared by Zespan''s own API contract: its resource groups, objects and enumerations, with the contract''s definitions.
    Derived, not authored.'
  version: '2026-10-19'
  terms:
  - term: PostHandleRequest
    definition: 'Object declared by the contract with fields: orderId.'
    tags:
    - Object
    source: openapi/_ae-authored/zespan-openapi-generated.yml#/components/schemas/PostHandleRequest
  - term: PostV1AuthDeviceCodeRequest
    definition: 'Object declared by the contract with fields: client_id.'
    tags:
    - Object
    source: openapi/_ae-authored/zespan-openapi-generated.yml#/components/schemas/PostV1AuthDeviceCodeRequest
  - term: GetV1OrgsOrgidPoliciesResponse
    definition: 'Object declared by the contract with fields: 200, 400, 403.'
    tags:
    - Object
    source: openapi/_ae-authored/zespan-openapi-generated.yml#/components/schemas/GetV1OrgsOrgidPoliciesResponse
  - term: GetV1OrgsOrgidPolicyAppliesResponse
    definition: 'Object declared by the contract with fields: 200, 403.'
    tags:
    - Object
    source: openapi/_ae-authored/zespan-openapi-generated.yml#/components/schemas/GetV1OrgsOrgidPolicyAppliesResponse
  - term: PostV1PromptsNameVersionsVersionGateRequest
    definition: 'Object declared by the contract with fields: name, version, dataset-run-id, evaluator-id, baseline-run-id, baseline-label, connection-id,
      regression-run-id.'
    tags:
    - Object
    source: openapi/_ae-authored/zespan-openapi-generated.yml#/components/schemas/PostV1PromptsNameVersionsVersionGateRequest
  - term: GetV1SdkConfigResponse
    definition: 'Object declared by the contract with fields: config.'
    tags:
    - Object
    source: openapi/_ae-authored/zespan-openapi-generated.yml#/components/schemas/GetV1SdkConfigResponse
  - term: PostWebhooksZespanRequest
    definition: 'Object declared by the contract with fields: event, alert_id, rule_name, metric, condition, threshold, current_value, window_min,
      fired_at, dashboard_url, signature.'
    tags:
    - Object
    source: openapi/_ae-authored/zespan-openapi-generated.yml#/components/schemas/PostWebhooksZespanRequest
  - term: PostWebhooksZespanResponse
    definition: 'Object declared by the contract with fields: received.'
    tags:
    - Object
    source: openapi/_ae-authored/zespan-openapi-generated.yml#/components/schemas/PostWebhooksZespanResponse
  - term: Handle
    definition: 'Resource group in the contract; its operation POST /handle: POST /handle'
    tags:
    - Resource Group
    source: openapi/_ae-authored/zespan-openapi-generated.yml
  - term: Auth
    definition: 'Resource group in the contract; its operation POST /v1/auth/device/code: POST /v1/auth/device/code'
    tags:
    - Resource Group
    source: openapi/_ae-authored/zespan-openapi-generated.yml
  - term: Ingest
    definition: 'Resource group in the contract; its operation POST /v1/ingest: Send trace and span events with the native NDJSON endpoint, or
      via OpenTelemetry.'
    tags:
    - Resource Group
    source: openapi/_ae-authored/zespan-openapi-generated.yml
  - term: Model Catalogue
    definition: 'Resource group in the contract; its operation GET /v1/model-catalogue: GET /v1/model-catalogue returns the full bundled feed
      — every entry, not scoped to a project — for any project member.'
    tags:
    - Resource Group
    source: openapi/_ae-authored/zespan-openapi-generated.yml
  - term: Orgs
    definition: 'Resource group in the contract; its operation GET /v1/orgs/{orgid}/policies: Every policy id enforced (or once enforced) anywhere
      in the organisation, one group per id, with every project/environment occurrence underneath it.'
    tags:
    - Resource Group
    source: openapi/_ae-authored/zespan-openapi-generated.yml
  - term: Prompts
    definition: 'Resource group in the contract; its operation GET /v1/prompts: GET /v1/prompts'
    tags:
    - Resource Group
    source: openapi/_ae-authored/zespan-openapi-generated.yml
  - term: Sdk
    definition: 'Resource group in the contract; its operation GET /v1/sdk/config: If the server version is higher, the SDK makes a single background
      request to GET /v1/sdk/config and applies the returned configuration rules immediately.'
    tags:
    - Resource Group
    source: openapi/_ae-authored/zespan-openapi-generated.yml
  - term: Enqueue
    definition: 'Resource group in the contract; its operation POST /v2/enqueue: POST /v2/enqueue'
    tags:
    - Resource Group
    source: openapi/_ae-authored/zespan-openapi-generated.yml
  - term: Webhooks
    definition: 'Resource group in the contract; its operation POST /webhooks/zespan: Webhooks — receive real-time alert notifications'
    tags:
    - Resource Group
    source: openapi/_ae-authored/zespan-openapi-generated.yml