API Evangelist enhancements for the Ghost API

overlay: 1.0.0
info:
  title: API Evangelist enhancements for the Ghost API
  version: 1.0.0
extends: openapi/timescale-ghost-openapi-original.yml
x-generated: '2026-08-05'
x-method: generated
x-source: openapi/timescale-ghost-openapi-original.yml
actions:
- target: $.info
  update:
    x-apievangelist-provider: timescale
    x-apievangelist-provider-name: Tiger Data (formerly Timescale)
    x-apievangelist-product: Ghost — "give every agent its own database"
    x-apievangelist-harvested-from: https://raw.githubusercontent.com/timescale/ghost/main/openapi.yaml
    x-apievangelist-docs: https://ghost.build/docs/#api-reference
- target: $.info
  update:
    x-apievangelist-untagged: >-
      Not one of the 48 operations carries a tags[] entry and the document declares no
      top-level tags block, so every operation renders under a single default group.
      Adding tags (auth, spaces, members, invites, api-keys, databases, sharing,
      billing, analytics) is the single highest-value change to this spec.
- target: $.info
  update:
    x-apievangelist-agentic-surface:
      note: >-
        Ghost is explicitly built for agents and ships an MCP server in its CLI, yet
        API-key minting (createApiKey/deleteApiKey) and payment-method operations have
        no MCP tool — a deliberate and defensible boundary.
      crosswalk: mcp/timescale-tool-crosswalk.yml
- target: $.paths['/health'].get
  update:
    x-apievangelist-probe:
      url: https://api.ghost.build/v0/health
      http_status: 200
      fetched: '2026-08-05'
      note: the only anonymously reachable operation; confirms the spec describes a live service