overlay: 1.0.0
info:
  title: API Evangelist enhancements for HiveLaw — AI Legal Contracts & Compliance API
  version: '2026-09-19'
  x-generated: '2026-09-19'
  x-method: generated
  x-source: openapi/hiveagentiq-com-hivelaw-openapi.json
  x-note: Adds operationIds (the provider declares none), a tag per service, per-operation USDC prices decoded from
    x-mpp-charge, the observed 401 envelope, an auth note and, for HiveBank/HiveLaw, the first-party host as an
    additional server. Never mutates the original file.
extends: https://hivelaw.hiveagentiq.com/openapi.json
x-extends-local: openapi/hiveagentiq-com-hivelaw-openapi.json
actions:
- target: $.tags
  update:
  - name: Legal
    description: HiveLaw — AI Legal Contracts & Compliance API operations (tag added by API Evangelist; the provider
      declares none).
- target: $.info
  update:
    x-apievangelist-provider: Hive Agent IQ (hiveagentiq.com); sibling brand Hive Civilization (thehiveryiq.com)
      is the spec contact
    x-apievangelist-auth-note: No securitySchemes are declared. Writes require a Hive DID from POST https://hivegate.hiveagentiq.com/v1/gate/onboard;
      metered operations answer 402 and settle via x402 (X-Payment, USDC on Base) or MPP. See authentication/hiveagentiq-com-authentication.yml.
    x-apievangelist-rate-limit: X-RateLimit-Limit 100 per hour with X-RateLimit-Remaining / X-RateLimit-Reset (epoch
      ms) on hivetrust and hivelaw; none observed on hivegate and hivebank.
- target: $.servers
  update:
  - url: https://hivelaw.hiveagentiq.com
    description: First-party host on the company domain (CNAME to the hivelaw.onrender.com Render origin the provider
      declares); both serve identical bytes.
- target: $.paths['/v1/law/contract/draft'].post
  update:
    operationId: draftContract
    tags:
    - Legal
    x-apievangelist-price-usdc: 0.5
- target: $.paths['/v1/law/contract/draft'].post.responses
  update:
    '401':
      description: 'agent_not_registered — no Hive DID presented (X-API-Key, Authorization: Bearer did:hive:* or
        X-Hive-DID). Observed live on this estate; not declared by the provider.'
- target: $.paths['/v1/law/contract/review'].post
  update:
    operationId: reviewContract
    tags:
    - Legal
    x-apievangelist-price-usdc: 0.5
- target: $.paths['/v1/law/contract/review'].post.responses
  update:
    '401':
      description: 'agent_not_registered — no Hive DID presented (X-API-Key, Authorization: Bearer did:hive:* or
        X-Hive-DID). Observed live on this estate; not declared by the provider.'
- target: $.paths['/v1/law/contract/seal'].post
  update:
    operationId: sealContract
    tags:
    - Legal
    x-apievangelist-price-usdc: 0.5
- target: $.paths['/v1/law/contract/seal'].post.responses
  update:
    '401':
      description: 'agent_not_registered — no Hive DID presented (X-API-Key, Authorization: Bearer did:hive:* or
        X-Hive-DID). Observed live on this estate; not declared by the provider.'
- target: $.paths['/v1/comply/start'].post
  update:
    operationId: startComplianceStarter
    tags:
    - Legal
    x-apievangelist-price-usdc: 500.0
- target: $.paths['/v1/comply/start'].post.responses
  update:
    '401':
      description: 'agent_not_registered — no Hive DID presented (X-API-Key, Authorization: Bearer did:hive:* or
        X-Hive-DID). Observed live on this estate; not declared by the provider.'
- target: $.paths['/v1/comply/start/pro'].post
  update:
    operationId: startCompliancePro
    tags:
    - Legal
    x-apievangelist-price-usdc: 1500.0
- target: $.paths['/v1/comply/start/pro'].post.responses
  update:
    '401':
      description: 'agent_not_registered — no Hive DID presented (X-API-Key, Authorization: Bearer did:hive:* or
        X-Hive-DID). Observed live on this estate; not declared by the provider.'
- target: $.paths['/v1/comply/start/enterprise'].post
  update:
    operationId: startComplianceEnterprise
    tags:
    - Legal
    x-apievangelist-price-usdc: 2500.0
- target: $.paths['/v1/comply/start/enterprise'].post.responses
  update:
    '401':
      description: 'agent_not_registered — no Hive DID presented (X-API-Key, Authorization: Bearer did:hive:* or
        X-Hive-DID). Observed live on this estate; not declared by the provider.'