openapi: 3.1.0
info:
  title: A2A Commerce Gateway
  version: 1.4.10
  description: 'A2A Commerce Gateway — agent-to-agent commerce infrastructure operated by Green Helix Consulting, LLC: billing
    and wallets, payment intents and escrow, subscriptions, Ed25519 agent identity and reputation, service marketplace, trust
    scoring, encrypted messaging and price negotiation, disputes, webhooks and an event bus. 114 paths / 132 operations under
    /v1. Description, servers[] and contact were added by API Evangelist from the provider''s own homepage, agent card and
    ai-plugin.json; the verbatim contract as served is in openapi/_original/greenhelix-net-openapi.json.'
  contact:
    name: Green Helix
    url: https://greenhelix.net
    email: support@greenhelix.net
paths:
  /livez:
    get:
      summary: Livez
      description: Kubernetes liveness probe — no auth, no DB.
      operationId: livez_livez_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /readyz:
    get:
      summary: Readyz
      description: Kubernetes readiness probe — checks billing DB.
      operationId: readyz_readyz_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /v1/health:
    get:
      summary: Health
      operationId: health_v1_health_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /v1/pricing:
    get:
      summary: Pricing List
      description: "Return the tool catalog with optional pagination.\n\nQuery params:\n    limit (int, optional): Max number\
        \ of tools to return. Negative values ignored.\n    offset (int, optional): Number of tools to skip. Default 0.\n\
        \    cursor (str, optional): Opaque cursor from previous page's next_cursor."
      operationId: pricing_list_v1_pricing_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /v1/pricing/summary:
    get:
      summary: Pricing Summary
      description: Return pricing grouped by service for a quick overview.
      operationId: pricing_summary_v1_pricing_summary_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /v1/pricing/tiers:
    get:
      summary: Pricing Tiers
      description: Return a human-readable comparison of all API tiers.
      operationId: pricing_tiers_v1_pricing_tiers_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /v1/pricing/{tool}:
    get:
      summary: Pricing Detail
      description: Return pricing info for a single tool.
      operationId: pricing_detail_v1_pricing__tool__get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /v1/execute:
    post:
      summary: Execute
      description: 'Execute a tool. Wraps the real implementation so EVERY response

        — success, 410 moved, 4xx, 5xx — carries RFC 8594 deprecation

        headers (Deprecation + Sunset + Link rel=sunset).'
      operationId: execute_v1_execute_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      requestBody:
        content:
          application/json:
            examples:
              get_balance:
                summary: Get the current wallet balance for an agent in a specific currency.
                value:
                  tool: get_balance
                  params:
                    agent_id: example-agent_id
              get_usage_summary:
                summary: Get usage summary (total cost, calls, tokens) for an agent.
                value:
                  tool: get_usage_summary
                  params:
                    agent_id: example-agent_id
              deposit:
                summary: Deposit funds into an agent's wallet in a specific currency.
                value:
                  tool: deposit
                  params:
                    agent_id: example-agent_id
                    amount: 1.0
              get_transactions:
                summary: Get the transaction ledger for an agent (deposits, withdrawals, charges).
                value:
                  tool: get_transactions
                  params:
                    agent_id: example-agent_id
              create_intent:
                summary: Create a payment intent between two agents.
                value:
                  tool: create_intent
                  params:
                    payer: example-payer
                    payee: example-payee
                    amount: 1.0
              get_intent:
                summary: Get details of a payment intent by its ID.
                value:
                  tool: get_intent
                  params:
                    intent_id: example-intent_id
              get_escrow:
                summary: Get details of an escrow by its ID.
                value:
                  tool: get_escrow
                  params:
                    escrow_id: example-escrow_id
              capture_intent:
                summary: Capture (settle) a pending payment intent.
                value:
                  tool: capture_intent
                  params:
                    intent_id: example-intent_id
              partial_capture:
                summary: Partially capture a pending payment intent for a specified amount.
                value:
                  tool: partial_capture
                  params:
                    intent_id: example-intent_id
                    amount: 1.0
              create_escrow:
                summary: Create an escrow between two agents. Funds are held from payer immediately.
                value:
                  tool: create_escrow
                  params:
                    payer: example-payer
                    payee: example-payee
                    amount: 1.0
              release_escrow:
                summary: Release escrowed funds to the payee.
                value:
                  tool: release_escrow
                  params:
                    escrow_id: example-escrow_id
              cancel_escrow:
                summary: Cancel a held escrow and refund the payer.
                value:
                  tool: cancel_escrow
                  params:
                    escrow_id: example-escrow_id
              list_intents:
                summary: List payment intents for an agent, optionally filtered by status.
                value:
                  tool: list_intents
                  params:
                    agent_id: example-agent_id
              list_escrows:
                summary: List escrows for an agent, optionally filtered by status.
                value:
                  tool: list_escrows
                  params:
                    agent_id: example-agent_id
              refund_intent:
                summary: 'Refund a payment intent: voids if pending, reverse-transfers if settled.'
                value:
                  tool: refund_intent
                  params:
                    intent_id: example-intent_id
              refund_settlement:
                summary: Refund a settled payment (full or partial). If amount is omitted, refunds the full remaining balance.
                value:
                  tool: refund_settlement
                  params:
                    settlement_id: example-settlement_id
              search_services:
                summary: Search the marketplace for available services. Supports pagination via paginate=true.
                value:
                  tool: search_services
                  params: {}
              search_agents:
                summary: Search for agents by capability keywords. Searches service names, descriptions, tools, tags, and
                  categories. Supports pagination via paginate=true.
                value:
                  tool: search_agents
                  params:
                    query: example-query
              best_match:
                summary: Find the best matching services for a query with ranking.
                value:
                  tool: best_match
                  params:
                    query: example-query
              register_service:
                summary: Register a new service in the marketplace.
                value:
                  tool: register_service
                  params:
                    provider_id: example-provider_id
                    name: example-name
                    description: example-description
                    category: example-category
              get_service:
                summary: Get a marketplace service by its ID.
                value:
                  tool: get_service
                  params:
                    service_id: example-service_id
              update_service:
                summary: Update fields on an existing marketplace service.
                value:
                  tool: update_service
                  params:
                    service_id: example-service_id
              deactivate_service:
                summary: Deactivate a marketplace service listing.
                value:
                  tool: deactivate_service
                  params:
                    service_id: example-service_id
              get_trust_score:
                summary: Get the trust score for a server.
                value:
                  tool: get_trust_score
                  params: {}
              search_servers:
                summary: Search for servers by name or minimum trust score.
                value:
                  tool: search_servers
                  params: {}
              get_payment_history:
                summary: Get payment history for an agent.
                value:
                  tool: get_payment_history
                  params:
                    agent_id: example-agent_id
              register_server:
                summary: Register a new server for trust tracking.
                value:
                  tool: register_server
                  params:
                    name: example-name
                    url: example-url
              delete_server:
                summary: Delete a server and all its associated trust data (probes, scans, scores).
                value:
                  tool: delete_server
                  params: {}
              update_server:
                summary: Update a server's name and/or URL.
                value:
                  tool: update_server
                  params: {}
              get_global_audit_log:
                summary: Get the global audit log across all agents (admin operation).
                value:
                  tool: get_global_audit_log
                  params: {}
              publish_event:
                summary: Publish an event to the cross-product event bus.
                value:
                  tool: publish_event
                  params:
                    event_type: example-event_type
                    source: example-source
              get_events:
                summary: Query events from the event bus with optional type filter and offset.
                value:
                  tool: get_events
                  params: {}
              register_webhook:
                summary: Register a webhook endpoint to receive event notifications.
                value:
                  tool: register_webhook
                  params:
                    agent_id: example-agent_id
                    url: example-url
                    event_types: []
              list_webhooks:
                summary: List all registered webhooks for an agent. Supports pagination via paginate=true.
                value:
                  tool: list_webhooks
                  params:
                    agent_id: example-agent_id
              delete_webhook:
                summary: Delete (deactivate) a webhook by its ID.
                value:
                  tool: delete_webhook
                  params:
                    webhook_id: example-webhook_id
              get_webhook_deliveries:
                summary: Get delivery history for a webhook endpoint.
                value:
                  tool: get_webhook_deliveries
                  params:
                    webhook_id: example-webhook_id
              process_due_subscriptions:
                summary: Trigger processing of all due subscriptions and expired escrows.
                value:
                  tool: process_due_subscriptions
                  params: {}
              register_agent:
                summary: Register a cryptographic identity for an agent. Generates Ed25519 keypair.
                value:
                  tool: register_agent
                  params:
                    agent_id: example-agent_id
              verify_agent:
                summary: Verify that a message was signed by the claimed agent.
                value:
                  tool: verify_agent
                  params:
                    agent_id: example-agent_id
                    message: example-message
                    signature: example-signature
              submit_metrics:
                summary: Submit trading bot metrics (Sharpe, drawdown, latency, etc.) for platform attestation.
                value:
                  tool: submit_metrics
                  params:
                    agent_id: example-agent_id
                    metrics: {}
              get_agent_identity:
                summary: Get the cryptographic identity and public key for an agent.
                value:
                  tool: get_agent_identity
                  params:
                    agent_id: example-agent_id
              get_verified_claims:
                summary: Get all verified metric claims for an agent (e.g., Sharpe >= 2.0).
                value:
                  tool: get_verified_claims
                  params:
                    agent_id: example-agent_id
              get_agent_reputation:
                summary: Get the consumer-side reputation score for an agent.
                value:
                  tool: get_agent_reputation
                  params:
                    agent_id: example-agent_id
              create_subscription:
                summary: Create a recurring payment subscription between two agents.
                value:
                  tool: create_subscription
                  params:
                    payer: example-payer
                    payee: example-payee
                    amount: 1.0
                    interval: example-interval
              cancel_subscription:
                summary: Cancel an active or suspended subscription.
                value:
                  tool: cancel_subscription
                  params:
                    subscription_id: example-subscription_id
              get_subscription:
                summary: Get details of a subscription by ID.
                value:
                  tool: get_subscription
                  params:
                    subscription_id: example-subscription_id
              list_subscriptions:
                summary: List subscriptions for an agent (as payer or payee).
                value:
                  tool: list_subscriptions
                  params: {}
              reactivate_subscription:
                summary: Reactivate a suspended subscription.
                value:
                  tool: reactivate_subscription
                  params:
                    subscription_id: example-subscription_id
              create_wallet:
                summary: Create a new wallet for an agent (self-service onboarding).
                value:
                  tool: create_wallet
                  params:
                    agent_id: example-agent_id
              withdraw:
                summary: Withdraw funds from an agent's wallet in a specific currency.
                value:
                  tool: withdraw
                  params:
                    agent_id: example-agent_id
                    amount: 1.0
              search_agents_by_metrics:
                summary: Search for agents with verified metric claims (e.g., find bots with Sharpe >= 2.0).
                value:
                  tool: search_agents_by_metrics
                  params:
                    metric_name: example-metric_name
              create_performance_escrow:
                summary: Create an escrow that auto-releases when payee's verified metrics meet a threshold.
                value:
                  tool: create_performance_escrow
                  params:
                    payer: example-payer
                    payee: example-payee
                    amount: 1.0
                    metric_name: example-metric_name
                    threshold: 1.0
              check_performance_escrow:
                summary: Check if a performance-gated escrow's metric threshold is met and auto-release if so.
                value:
                  tool: check_performance_escrow
                  params:
                    escrow_id: example-escrow_id
              open_dispute:
                summary: Open a dispute against an escrow.
                value:
                  tool: open_dispute
                  params:
                    escrow_id: example-escrow_id
                    opener: example-opener
              respond_to_dispute:
                summary: Respond to an open dispute.
                value:
                  tool: respond_to_dispute
                  params:
                    dispute_id: example-dispute_id
                    respondent: example-respondent
                    response: example-response
              resolve_dispute:
                summary: Resolve a dispute by refunding payer or releasing funds to payee.
                value:
                  tool: resolve_dispute
                  params:
                    dispute_id: example-dispute_id
                    resolution: example-resolution
                    resolved_by: example-resolved_by
              get_dispute:
                summary: Get details of a dispute by its ID.
                value:
                  tool: get_dispute
                  params:
                    dispute_id: example-dispute_id
              list_disputes:
                summary: List disputes where the agent is opener or respondent.
                value:
                  tool: list_disputes
                  params:
                    agent_id: example-agent_id
              rotate_key:
                summary: 'Rotate an API key: revoke the current key and create a new one with the same tier.'
                value:
                  tool: rotate_key
                  params:
                    current_key: example-current_key
              build_claim_chain:
                summary: Build a Merkle tree from an agent's attestation history for verifiable claim chains.
                value:
                  tool: build_claim_chain
                  params:
                    agent_id: example-agent_id
              get_claim_chains:
                summary: Get stored Merkle claim chains for an agent.
                value:
                  tool: get_claim_chains
                  params:
                    agent_id: example-agent_id
              send_message:
                summary: Send a typed message to another agent.
                value:
                  tool: send_message
                  params:
                    sender: example-sender
                    recipient: example-recipient
                    message_type: example-message_type
              get_messages:
                summary: Get messages for an agent (sent and received).
                value:
                  tool: get_messages
                  params:
                    agent_id: example-agent_id
              negotiate_price:
                summary: Start a price negotiation with another agent.
                value:
                  tool: negotiate_price
                  params:
                    initiator: example-initiator
                    responder: example-responder
                    amount: 1.0
              check_sla_compliance:
                summary: Check if a server meets its claimed SLA using trust probe data.
                value:
                  tool: check_sla_compliance
                  params: {}
              list_strategies:
                summary: List signal provider strategies in the marketplace.
                value:
                  tool: list_strategies
                  params: {}
              get_service_analytics:
                summary: Get usage analytics for an agent (total calls, cost, tokens).
                value:
                  tool: get_service_analytics
                  params:
                    agent_id: example-agent_id
              get_revenue_report:
                summary: Get revenue report for a provider agent (incoming payments).
                value:
                  tool: get_revenue_report
                  params:
                    agent_id: example-agent_id
              create_split_intent:
                summary: Create a split payment across multiple payees with percentage-based distribution.
                value:
                  tool: create_split_intent
                  params:
                    payer: example-payer
                    amount: 1.0
                    splits: []
              backup_database:
                summary: Create a hot backup of a SQLite database, optionally encrypted with Fernet.
                value:
                  tool: backup_database
                  params:
                    database: example-database
              restore_database:
                summary: Restore a SQLite database from a backup file, with optional decryption.
                value:
                  tool: restore_database
                  params:
                    database: example-database
              check_db_integrity:
                summary: Run SQLite integrity check and return page diagnostics for a database.
                value:
                  tool: check_db_integrity
                  params:
                    database: example-database
              list_backups:
                summary: List all available database backup files.
                value:
                  tool: list_backups
                  params: {}
              stripe_list_customers:
                summary: List Stripe customers.
                value:
                  tool: stripe_list_customers
                  params: {}
              stripe_create_customer:
                summary: Create a Stripe customer.
                value:
                  tool: stripe_create_customer
                  params:
                    email: example-email
              stripe_list_products:
                summary: List Stripe products.
                value:
                  tool: stripe_list_products
                  params: {}
              stripe_create_product:
                summary: Create a Stripe product.
                value:
                  tool: stripe_create_product
                  params:
                    name: example-name
              stripe_list_prices:
                summary: List Stripe prices.
                value:
                  tool: stripe_list_prices
                  params: {}
              stripe_create_price:
                summary: Create a Stripe price.
                value:
                  tool: stripe_create_price
                  params:
                    product: example-product
                    unit_amount: 1
              stripe_create_payment_link:
                summary: Create a Stripe payment link.
                value:
                  tool: stripe_create_payment_link
                  params:
                    price: example-price
              stripe_list_invoices:
                summary: List Stripe invoices.
                value:
                  tool: stripe_list_invoices
                  params: {}
              stripe_create_invoice:
                summary: Create a Stripe invoice.
                value:
                  tool: stripe_create_invoice
                  params:
                    customer: example-customer
              stripe_list_subscriptions:
                summary: List Stripe subscriptions.
                value:
                  tool: stripe_list_subscriptions
                  params: {}
              stripe_cancel_subscription:
                summary: Cancel a Stripe subscription.
                value:
                  tool: stripe_cancel_subscription
                  params:
                    subscription_id: example-subscription_id
              stripe_create_refund:
                summary: Create a Stripe refund.
                value:
                  tool: stripe_create_refund
                  params:
                    payment_intent: example-payment_intent
              stripe_retrieve_balance:
                summary: Retrieve Stripe account balance.
                value:
                  tool: stripe_retrieve_balance
                  params: {}
              github_list_repos:
                summary: List GitHub repositories.
                value:
                  tool: github_list_repos
                  params: {}
              github_get_repo:
                summary: Get GitHub repository metadata.
                value:
                  tool: github_get_repo
                  params:
                    owner: example-owner
                    repo: example-repo
              github_list_issues:
                summary: List issues in a repository.
                value:
                  tool: github_list_issues
                  params:
                    owner: example-owner
                    repo: example-repo
              github_create_issue:
                summary: Create an issue in a repository.
                value:
                  tool: github_create_issue
                  params:
                    owner: example-owner
                    repo: example-repo
                    title: example-title
              github_list_pull_requests:
                summary: List pull requests.
                value:
                  tool: github_list_pull_requests
                  params:
                    owner: example-owner
                    repo: example-repo
              github_get_pull_request:
                summary: Get pull request details.
                value:
                  tool: github_get_pull_request
                  params:
                    owner: example-owner
                    repo: example-repo
                    pull_number: 1
              github_create_pull_request:
                summary: Create a pull request.
                value:
                  tool: github_create_pull_request
                  params:
                    owner: example-owner
                    repo: example-repo
                    title: example-title
                    head: example-head
                    base: example-base
              github_list_commits:
                summary: List commits in a repository.
                value:
                  tool: github_list_commits
                  params:
                    owner: example-owner
                    repo: example-repo
              github_get_file_contents:
                summary: Get file contents from a repository.
                value:
                  tool: github_get_file_contents
                  params:
                    owner: example-owner
                    repo: example-repo
                    path: example-path
              github_search_code:
                summary: Search code across repositories.
                value:
                  tool: github_search_code
                  params:
                    query: example-query
              pg_query:
                summary: Execute a read-only SQL query.
                value:
                  tool: pg_query
                  params:
                    sql: example-sql
              pg_execute:
                summary: Execute a SQL statement (if write-enabled).
                value:
                  tool: pg_execute
                  params:
                    sql: example-sql
              pg_list_tables:
                summary: List tables in the database.
                value:
                  tool: pg_list_tables
                  params: {}
              pg_describe_table:
                summary: Describe a table's columns and types.
                value:
                  tool: pg_describe_table
                  params:
                    table: example-table
              pg_explain_query:
                summary: EXPLAIN a SQL query plan.
                value:
                  tool: pg_explain_query
                  params:
                    sql: example-sql
              pg_list_schemas:
                summary: List schemas in the database.
                value:
                  tool: pg_list_schemas
                  params: {}
              get_metrics_timeseries:
                summary: Get per-agent usage metrics bucketed by hour or day.
                value:
                  tool: get_metrics_timeseries
                  params:
                    agent_id: example-agent_id
                    interval: example-interval
              get_agent_leaderboard:
                summary: Rank agents by total spend, calls, trust score, revenue, or rating.
                value:
                  tool: get_agent_leaderboard
                  params:
                    metric: example-metric
              register_event_schema:
                summary: Register a JSON schema for an event type in the event bus.
                value:
                  tool: register_event_schema
                  params:
                    event_type: example-event_type
                    schema: {}
              get_event_schema:
                summary: Retrieve the registered JSON schema for an event type.
                value:
                  tool: get_event_schema
                  params:
                    event_type: example-event_type
              test_webhook:
                summary: Send a test ping event to a registered webhook and return the delivery result.
                value:
                  tool: test_webhook
                  params:
                    webhook_id: example-webhook_id
              create_api_key:
                summary: Create a new API key for yourself (self-service). Only same-agent or admin can create.
                value:
                  tool: create_api_key
                  params:
                    agent_id: example-agent_id
              get_volume_discount:
                summary: Calculate discounted price based on historical usage volume.
                value:
                  tool: get_volume_discount
                  params:
                    agent_id: example-agent_id
                    tool_name: example-tool_name
                    quantity: 1
              estimate_cost:
                summary: Calculate projected cost of N calls to a specific tool without executing them.
                value:
                  tool: estimate_cost
                  params:
                    tool_name: example-tool_name
                    quantity: 1
              rate_service:
                summary: Rate a marketplace service (1-5). One rating per agent per service (upsert).
                value:
                  tool: rate_service
                  params:
                    service_id: example-service_id
                    agent_id: example-agent_id
                    rating: 1
              get_service_ratings:
                summary: Get ratings and reviews for a marketplace service.
                value:
                  tool: get_service_ratings
                  params:
                    service_id: example-service_id
              set_budget_cap:
                summary: Set daily/monthly spending caps and alert thresholds for an agent.
                value:
                  tool: set_budget_cap
                  params:
                    agent_id: example-agent_id
              get_budget_status:
                summary: Get current spending vs budget caps and alert status for an agent.
                value:
                  tool: get_budget_status
                  params:
                    agent_id: example-agent_id
              freeze_wallet:
                summary: Freeze a wallet, blocking all deposits and withdrawals. Admin only.
                value:
                  tool: freeze_wallet
                  params:
                    agent_id: example-agent_id
              unfreeze_wallet:
                summary: Unfreeze a wallet, allowing deposits and withdrawals again. Admin only.
                value:
                  tool: unfreeze_wallet
                  params:
                    agent_id: example-agent_id
              create_org:
                summary: Create a new organization.
                value:
                  tool: create_org
                  params:
                    org_name: example-org_name
              get_org:
                summary: Get organization details and members.
                value:
                  tool: get_org
                  params:
                    org_id: example-org_id
              add_agent_to_org:
                summary: Add an agent to an organization.
                value:
                  tool: add_agent_to_org
                  params:
                    org_id: example-org_id
                    agent_id: example-agent_id
              remove_agent_from_org:
                summary: Remove an agent from an organization. Cannot remove the last owner.
                value:
                  tool: remove_agent_from_org
                  params:
                    org_id: example-org_id
                    agent_id: example-agent_id
              list_api_keys:
                summary: List all API keys for an agent. Returns truncated key hash prefix, tier, scopes, and created_at (never
                  the full key or hash). Supports pagination via paginate=true.
                value:
                  tool: list_api_keys
                  params:
                    agent_id: example-agent_id
              revoke_api_key:
                summary: Soft-delete (revoke) an API key by its hash prefix. The key will no longer be usable for authentication.
                value:
                  tool: revoke_api_key
                  params:
                    agent_id: example-agent_id
                    key_hash_prefix: example-key_hash_prefix
              get_exchange_rate:
                summary: Query the exchange rate between two supported currencies.
                value:
                  tool: get_exchange_rate
                  params:
                    from_currency: example-from_currency
                    to_currency: example-to_currency
              convert_currency:
                summary: Convert funds between currency balances for an agent. Withdraws from source currency and deposits
                  converted amount to target currency.
                value:
                  tool: convert_currency
                  params:
                    agent_id: example-agent_id
                    amount: 1.0
                    from_currency: example-from_currency
                    to_currency: example-to_currency
              ingest_metrics:
                summary: Ingest time-series metric data points for an agent. Supports optional Ed25519 signature verification
                  for authenticated submissions.
                value:
                  tool: ingest_metrics
                  params:
                    agent_id: example-agent_id
                    metrics: {}
              query_metrics:
                summary: Query time-series metric data for a specific agent and metric name, with optional time range filtering.
                value:
                  tool: query_metrics
                  params:
                    agent_id: example-agent_id
                    metric_name: example-metric_name
              get_metric_deltas:
                summary: Get performance deltas (current vs previous value) for an agent across all metrics or a specific
                  metric.
                value:
                  tool: get_metric_deltas
                  params:
                    agent_id: example-agent_id
              get_metric_averages:
                summary: Get pre-computed rolling averages for an agent over a specified period (7d, 30d, or 90d).
                value:
                  tool: get_metric_averages
                  params:
                    agent_id: example-agent_id
              submit_verification:
                summary: Submit a formal verification job. Each property can be written as raw Z3 SMT-LIB2 (language='z3_smt2')
                  or as a structured JSON policy (language='json_policy', compiled server-side to SMT-LIB2). Returns a job
                  ID for tracking.
                value:
                  tool: submit_verification
                  params:
                    agent_id: example-agent_id
                    properties: []
              get_verification_status:
                summary: Get the current status and result of a verification job.
                value:
                  tool: get_verification_status
                  params:
                    job_id: example-job_id
              list_verification_jobs:
                summary: List verification jobs for an agent with optional status filter.
                value:
                  tool: list_verification_jobs
                  params:
                    agent_id: example-agent_id
              cancel_verification:
                summary: Cancel a pending or running verification job.
                value:
                  tool: cancel_verification
                  params:
                    job_id: example-job_id
              get_proof:
                summary: Retrieve a formal verification proof artifact by ID.
                value:
                  tool: get_proof
                  params:
                    proof_id: example-proof_id
              verify_proof:
                summary: Verify a formal verification proof by its SHA3-256 hash. Returns validity status.
                value:
                  tool: verify_proof
                  params:
                    proof_hash: example-proof_hash
              atlas_discover:
                summary: 'Enriched agent discovery: marketplace search + trust breakdown + reputation + ratings → Atlas Score.'
                value:
                  tool: atlas_discover
                  params:
                    query: example-query
              atlas_preflight:
                summary: 'Pre-transaction verification: endpoint reachable? trust OK? wallet active? pricing unchanged?'
                value:
                  tool: atlas_preflight
                  params:
                    service_id: example-service_id
              atlas_broker:
                summary: 'One-call brokering: discover → preflight → create payment intent.'
                value:
                  tool: atlas_broker
                  params:
                    query: example-query
                    payer: example-payer
  /v1/batch:
    post:
      summary: Batch
      description: Execute multiple tool calls in a single request.
      operationId: batch_v1_batch_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /v1/events/stream:
    get:
      summary: Event Stream
      description: "Stream events via Server-Sent Events (SSE).\n\nRequires API key via Authorization header.\nAccepts query\
        \ params:\n  - event_type (optional): filter by event type\n  - since_id (optional): only events after this ID\n \
        \ - agent_id (optional): filter events by source agent\nAccepts headers:\n  - Last-Event-ID: resume from this event\
        \ ID (overrides since_id)"
      operationId: event_stream_v1_events_stream_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /v1/ws:
    get:
      summary: Websocket Upgrade Fallback
      description: 'Return a helpful error when a plain HTTP request hits the WS endpoint.


        This happens when Cloudflare or another reverse proxy strips the

        ``Upgrade: websocket`` header.  A 426 status code tells the client

        that the server requires a protocol upgrade.'
      operationId: websocket_upgrade_fallback_v1_ws_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /v1/onboarding:
    get:
      summary: Onboarding Handler
      description: Return enriched OpenAPI spec with onboarding guide.
      operationId: onboarding_handler_v1_onboarding_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /v1/register:
    post:
      summary: Register
      description: 'Register a new agent: create wallet + free-tier API key.'
      operationId: register_v1_register_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /v1/checkout/success:
    get:
      summary: Checkout Success
      description: Branded post-payment confirmation page.
      operationId: checkout_success_v1_checkout_success_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /v1/checkout/cancelled:
    get:
      summary: Checkout Cancelled
      description: Branded payment-cancelled page.
      operationId: checkout_cancelled_v1_checkout_cancelled_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /v1/checkout:
    post:
      summary: Create Checkout
      description: "Create a Stripe Checkout session for credit purchase.\n\nBody:\n    {\"package\": \"starter\"} — use preset\
        \ package\n    {\"credits\": 5000}      — custom amount ($1 = 100 credits)"
      operationId: create_checkout_v1_checkout_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /v1/stripe-webhook:
    post:
      summary: Stripe Webhook
      description: 'Handle Stripe webhook events.


        On checkout.session.completed → deposit credits to agent''s wallet.'
      operationId: stripe_webhook_v1_stripe_webhook_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /v1/billing/wallets/{agent_id}/balance:
    get:
      tags:
      - billing
      summary: Get Balance
      operationId: get_balance_v1_billing_wallets__agent_id__balance_get
      parameters:
      - name: agent_id
        in: path
        required: true
        schema:
          type: string
          title: Agent Id
      - name: currency
        in: query
        required: false
        schema:
          type: string
          default: CREDITS
          title: Currency
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/billing/wallets:
    post:
      tags:
      - billing
      summary: Create Wallet
      operationId: create_wallet_v1_billing_wallets_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateWalletRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/billing/wallets/{agent_id}/deposit:
    post:
      tags:
      - billing
      summary: Deposit
      operationId: deposit_v1_billing_wallets__agent_id__deposit_post
      parameters:
      - name: agent_id
        in: path
        required: true
        schema:
          type: string
          title: Agent Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DepositRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/billing/wallets/{agent_id}/withdraw:
    post:
      tags:
      - billing
      summary: Withdraw
      operationId: withdraw_v1_billing_wallets__agent_id__withdraw_post
      parameters:
      - name: agent_id
        in: path
        required: true
        schema:
          type: string
          title: Agent Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/WithdrawRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/billing/wallets/{agent_id}/freeze:
    post:
      tags:
      - billing
      summary: Freeze Wallet
      operationId: freeze_wallet_v1_billing_wallets__agent_id__freeze_post
      parameters:
      - name: agent_id
        in: path
        required: true
        schema:
          type: string
          title: Agent Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/billing/wallets/{agent_id}/unfreeze:
    post:
      tags:
      - billing
      summary: Unfreeze Wallet
      operationId: unfreeze_wallet_v1_billing_wallets__agent_id__unfreeze_post
      parameters:
      - name: agent_id
        in: path
        required: true
        schema:
          type: string
          title: Agent Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/billing/wallets/{agent_id}/transactions:
    get:
      tags:
      - billing
      summary: Get Transactions
      operationId: get_transactions_v1_billing_wallets__agent_id__transactions_get
      parameters:
      - name: agent_id
        in: path
        required: true
        schema:
          type: string
          title: Agent Id
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          default: 100
          title: Limit
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          default: 0
          title: Offset
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/billing/wallets/{agent_id}/usage:
    get:
      tags:
      - billing
      summary: Get Usage Summary
      operationId: get_usage_summary_v1_billing_wallets__agent_id__usage_get
      parameters:
      - name: agent_id
        in: path
        required: true
        schema:
          type: string
          title: Agent Id
      - name: since
        in: query
        required: false
        schema:
          anyOf:
          - type: number
          - type: 'null'
          title: Since
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/billing/wallets/{agent_id}/analytics:
    get:
      tags:
      - billing
      summary: Get Service Analytics
      operationId: get_service_analytics_v1_billing_wallets__agent_id__analytics_get
      parameters:
      - name: agent_id
        in: path
        required: true
        schema:
          type: string
          title: Agent Id
      - name: since
        in: query
        required: false
        schema:
          anyOf:
          - type: number
          - type: 'null'
          title: Since
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/billing/wallets/{agent_id}/revenue:
    get:
      tags:
      - billing
      summary: Get Revenue Report
      operationId: get_revenue_report_v1_billing_wallets__agent_id__revenue_get
      parameters:
      - name: agent_id
        in: path
        required: true
        schema:
          type: string
          title: Agent Id
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          default: 50
          title: Limit
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/billing/wallets/{agent_id}/timeseries:
    get:
      tags:
      - billing
      summary: Get Metrics Timeseries
      operationId: get_metrics_timeseries_v1_billing_wallets__agent_id__timeseries_get
      parameters:
      - name: agent_id
        in: path
        required: true
        schema:
          type: string
          title: Agent Id
      - name: interval
        in: query
        required: false
        schema:
          type: string
          default: hour
          title: Interval
      - name: since
        in: query
        required: false
        schema:
          anyOf:
          - type: number
          - type: 'null'
          title: Since
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          default: 24
          title: Limit
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/billing/wallets/{agent_id}/budget:
    put:
      tags:
      - billing
      summary: Set Budget Cap
      operationId: set_budget_cap_v1_billing_wallets__agent_id__budget_put
      parameters:
      - name: agent_id
        in: path
        required: true
        schema:
          type: string
          title: Agent Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BudgetCapRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    get:
      tags:
      - billing
      summary: Get Budget Status
      operationId: get_budget_status_v1_billing_wallets__agent_id__budget_get
      parameters:
      - name: agent_id
        in: path
        required: true
        schema:
          type: string
          title: Agent Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/billing/leaderboard:
    get:
      tags:
      - billing
      summary: Get Agent Leaderboard
      operationId: get_agent_leaderboard_v1_billing_leaderboard_get
      parameters:
      - name: metric
        in: query
        required: false
        schema:
          type: string
          default: spend
          title: Metric
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          default: 10
          title: Limit
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/billing/discounts:
    get:
      tags:
      - billing
      summary: Get Volume Discount
      operationId: get_volume_discount_v1_billing_discounts_get
      parameters:
      - name: agent_id
        in: query
        required: true
        schema:
          type: string
          title: Agent Id
      - name: tool_name
        in: query
        required: true
        schema:
          type: string
          title: Tool Name
      - name: quantity
        in: query
        required: false
        schema:
          type: integer
          default: 1
          title: Quantity
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/billing/estimate:
    get:
      tags:
      - billing
      summary: Estimate Cost
      operationId: estimate_cost_v1_billing_estimate_get
      parameters:
      - name: tool_name
        in: query
        required: true
        schema:
          type: string
          title: Tool Name
      - name: quantity
        in: query
        required: false
        schema:
          type: integer
          default: 1
          title: Quantity
      - name: agent_id
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Agent Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/billing/exchange-rates:
    get:
      tags:
      - billing
      summary: Get Exchange Rate
      operationId: get_exchange_rate_v1_billing_exchange_rates_get
      parameters:
      - name: from_currency
        in: query
        required: true
        schema:
          type: string
          title: From Currency
      - name: to_currency
        in: query
        required: true
        schema:
          type: string
          title: To Currency
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/billing/keys:
    post:
      tags:
      - billing
      summary: Create Billing Api Key
      operationId: create_billing_api_key_v1_billing_keys_post
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateBillingApiKeyRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    get:
      tags:
      - billing
      summary: List Billing Api Keys
      description: 'List API keys owned by the authenticated caller.


        v1.2.4 audit P0-1: this is the non-admin self-service path.

        ``create_api_key`` is reused as the ``require_tool`` anchor

        (it is NOT in ``ADMIN_ONLY_TOOLS``) so free/pro tiers reach

        this handler without hitting the admin gate. The handler then

        calls the ``_list_api_keys`` implementation directly, always

        scoped to the authenticated caller''s ``agent_id`` via ownership.'
      operationId: list_billing_api_keys_v1_billing_keys_get
      parameters:
      - name: agent_id
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Agent Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/billing/wallets/{agent_id}/convert:
    post:
      tags:
      - billing
      summary: Convert Currency
      operationId: convert_currency_v1_billing_wallets__agent_id__convert_post
      parameters:
      - name: agent_id
        in: path
        required: true
        schema:
          type: string
          title: Agent Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ConvertCurrencyRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/disputes:
    post:
      tags:
      - disputes
      summary: Open Dispute
      operationId: open_dispute_v1_disputes_post
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OpenDisputeRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    get:
      tags:
      - disputes
      summary: List Disputes
      operationId: list_disputes_v1_disputes_get
      parameters:
      - name: agent_id
        in: query
        required: true
        schema:
          type: string
          title: Agent Id
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          default: 50
          title: Limit
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          default: 0
          title: Offset
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/disputes/{dispute_id}:
    get:
      tags:
      - disputes
      summary: Get Dispute
      operationId: get_dispute_v1_disputes__dispute_id__get
      parameters:
      - name: dispute_id
        in: path
        required: true
        schema:
          type: string
          title: Dispute Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/disputes/{dispute_id}/respond:
    post:
      tags:
      - disputes
      summary: Respond To Dispute
      operationId: respond_to_dispute_v1_disputes__dispute_id__respond_post
      parameters:
      - name: dispute_id
        in: path
        required: true
        schema:
          type: string
          title: Dispute Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RespondToDisputeRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/disputes/{dispute_id}/resolve:
    post:
      tags:
      - disputes
      summary: Resolve Dispute
      operationId: resolve_dispute_v1_disputes__dispute_id__resolve_post
      parameters:
      - name: dispute_id
        in: path
        required: true
        schema:
          type: string
          title: Dispute Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ResolveDisputeRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/payments/intents/split:
    post:
      tags:
      - payments
      summary: Create Split Intent
      operationId: create_split_intent_v1_payments_intents_split_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateSplitIntentRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/payments/intents:
    post:
      tags:
      - payments
      summary: Create Intent
      operationId: create_intent_v1_payments_intents_post
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateIntentRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    get:
      tags:
      - payments
      summary: List Intents
      operationId: list_intents_v1_payments_intents_get
      parameters:
      - name: agent_id
        in: query
        required: true
        schema:
          type: string
          title: Agent Id
      - name: status
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Status
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          default: 50
          title: Limit
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          default: 0
          title: Offset
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/payments/intents/{intent_id}:
    get:
      tags:
      - payments
      summary: Get Intent
      operationId: get_intent_v1_payments_intents__intent_id__get
      parameters:
      - name: intent_id
        in: path
        required: true
        schema:
          type: string
          title: Intent Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/payments/intents/{intent_id}/capture:
    post:
      tags:
      - payments
      summary: Capture Intent
      operationId: capture_intent_v1_payments_intents__intent_id__capture_post
      parameters:
      - name: intent_id
        in: path
        required: true
        schema:
          type: string
          title: Intent Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/payments/intents/{intent_id}/partial-capture:
    post:
      tags:
      - payments
      summary: Partial Capture
      operationId: partial_capture_v1_payments_intents__intent_id__partial_capture_post
      parameters:
      - name: intent_id
        in: path
        required: true
        schema:
          type: string
          title: Intent Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PartialCaptureRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/payments/intents/{intent_id}/refund:
    post:
      tags:
      - payments
      summary: Refund Intent
      operationId: refund_intent_v1_payments_intents__intent_id__refund_post
      parameters:
      - name: intent_id
        in: path
        required: true
        schema:
          type: string
          title: Intent Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/payments/escrows/performance:
    post:
      tags:
      - payments
      summary: Create Performance Escrow
      operationId: create_performance_escrow_v1_payments_escrows_performance_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreatePerformanceEscrowRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/payments/escrows:
    post:
      tags:
      - payments
      summary: Create Escrow
      operationId: create_escrow_v1_payments_escrows_post
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateEscrowRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    get:
      tags:
      - payments
      summary: List Escrows
      operationId: list_escrows_v1_payments_escrows_get
      parameters:
      - name: agent_id
        in: query
        required: true
        schema:
          type: string
          title: Agent Id
      - name: status
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Status
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          default: 50
          title: Limit
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          default: 0
          title: Offset
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/payments/escrows/{escrow_id}:
    get:
      tags:
      - payments
      summary: Get Escrow
      operationId: get_escrow_v1_payments_escrows__escrow_id__get
      parameters:
      - name: escrow_id
        in: path
        required: true
        schema:
          type: string
          title: Escrow Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/payments/escrows/{escrow_id}/release:
    post:
      tags:
      - payments
      summary: Release Escrow
      operationId: release_escrow_v1_payments_escrows__escrow_id__release_post
      parameters:
      - name: escrow_id
        in: path
        required: true
        schema:
          type: string
          title: Escrow Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/payments/escrows/{escrow_id}/cancel:
    post:
      tags:
      - payments
      summary: Cancel Escrow
      operationId: cancel_escrow_v1_payments_escrows__escrow_id__cancel_post
      parameters:
      - name: escrow_id
        in: path
        required: true
        schema:
          type: string
          title: Escrow Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/payments/escrows/{escrow_id}/check-performance:
    post:
      tags:
      - payments
      summary: Check Performance Escrow
      operationId: check_performance_escrow_v1_payments_escrows__escrow_id__check_performance_post
      parameters:
      - name: escrow_id
        in: path
        required: true
        schema:
          type: string
          title: Escrow Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/payments/settlements/{settlement_id}/refund:
    post:
      tags:
      - payments
      summary: Refund Settlement
      operationId: refund_settlement_v1_payments_settlements__settlement_id__refund_post
      parameters:
      - name: settlement_id
        in: path
        required: true
        schema:
          type: string
          title: Settlement Id
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
              - $ref: '#/components/schemas/RefundSettlementRequest'
              - type: 'null'
              title: Body
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/payments/history:
    get:
      tags:
      - payments
      summary: Get Payment History
      operationId: get_payment_history_v1_payments_history_get
      parameters:
      - name: agent_id
        in: query
        required: true
        schema:
          type: string
          title: Agent Id
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          default: 100
          title: Limit
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          default: 0
          title: Offset
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/payments/subscriptions/process-due:
    post:
      tags:
      - payments
      summary: Process Due Subscriptions
      operationId: process_due_subscriptions_v1_payments_subscriptions_process_due_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /v1/payments/subscriptions:
    post:
      tags:
      - payments
      summary: Create Subscription
      operationId: create_subscription_v1_payments_subscriptions_post
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateSubscriptionRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    get:
      tags:
      - payments
      summary: List Subscriptions
      operationId: list_subscriptions_v1_payments_subscriptions_get
      parameters:
      - name: agent_id
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Agent Id
      - name: status
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Status
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          default: 100
          title: Limit
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          default: 0
          title: Offset
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/payments/subscriptions/{subscription_id}:
    get:
      tags:
      - payments
      summary: Get Subscription
      operationId: get_subscription_v1_payments_subscriptions__subscription_id__get
      parameters:
      - name: subscription_id
        in: path
        required: true
        schema:
          type: string
          title: Subscription Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/payments/subscriptions/{subscription_id}/cancel:
    post:
      tags:
      - payments
      summary: Cancel Subscription
      operationId: cancel_subscription_v1_payments_subscriptions__subscription_id__cancel_post
      parameters:
      - name: subscription_id
        in: path
        required: true
        schema:
          type: string
          title: Subscription Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/payments/subscriptions/{subscription_id}/reactivate:
    post:
      tags:
      - payments
      summary: Reactivate Subscription
      operationId: reactivate_subscription_v1_payments_subscriptions__subscription_id__reactivate_post
      parameters:
      - name: subscription_id
        in: path
        required: true
        schema:
          type: string
          title: Subscription Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/identity/agents:
    post:
      tags:
      - identity
      summary: Register Agent
      operationId: register_agent_v1_identity_agents_post
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RegisterAgentRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    get:
      tags:
      - identity
      summary: Search Agents By Metrics
      operationId: search_agents_by_metrics_v1_identity_agents_get
      parameters:
      - name: metric_name
        in: query
        required: true
        schema:
          type: string
          title: Metric Name
      - name: min_value
        in: query
        required: false
        schema:
          anyOf:
          - type: number
          - type: 'null'
          title: Min Value
      - name: max_value
        in: query
        required: false
        schema:
          anyOf:
          - type: number
          - type: 'null'
          title: Max Value
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          default: 50
          title: Limit
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/identity/agents/{agent_id}:
    get:
      tags:
      - identity
      summary: Get Agent Identity
      operationId: get_agent_identity_v1_identity_agents__agent_id__get
      parameters:
      - name: agent_id
        in: path
        required: true
        schema:
          type: string
          title: Agent Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/identity/agents/{agent_id}/verify:
    post:
      tags:
      - identity
      summary: Verify Agent
      operationId: verify_agent_v1_identity_agents__agent_id__verify_post
      parameters:
      - name: agent_id
        in: path
        required: true
        schema:
          type: string
          title: Agent Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/VerifyAgentRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/identity/agents/{agent_id}/reputation:
    get:
      tags:
      - identity
      summary: Get Agent Reputation
      operationId: get_agent_reputation_v1_identity_agents__agent_id__reputation_get
      parameters:
      - name: agent_id
        in: path
        required: true
        schema:
          type: string
          title: Agent Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/identity/agents/{agent_id}/claims:
    get:
      tags:
      - identity
      summary: Get Verified Claims
      operationId: get_verified_claims_v1_identity_agents__agent_id__claims_get
      parameters:
      - name: agent_id
        in: path
        required: true
        schema:
          type: string
          title: Agent Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/identity/agents/{agent_id}/metrics:
    post:
      tags:
      - identity
      summary: Submit Metrics
      operationId: submit_metrics_v1_identity_agents__agent_id__metrics_post
      parameters:
      - name: agent_id
        in: path
        required: true
        schema:
          type: string
          title: Agent Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SubmitMetricsRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/identity/agents/{agent_id}/claim-chains:
    post:
      tags:
      - identity
      summary: Build Claim Chain
      operationId: build_claim_chain_v1_identity_agents__agent_id__claim_chains_post
      parameters:
      - name: agent_id
        in: path
        required: true
        schema:
          type: string
          title: Agent Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    get:
      tags:
      - identity
      summary: Get Claim Chains
      operationId: get_claim_chains_v1_identity_agents__agent_id__claim_chains_get
      parameters:
      - name: agent_id
        in: path
        required: true
        schema:
          type: string
          title: Agent Id
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          default: 10
          title: Limit
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/identity/orgs:
    post:
      tags:
      - identity
      summary: Create Org
      operationId: create_org_v1_identity_orgs_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateOrgRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/identity/orgs/{org_id}:
    get:
      tags:
      - identity
      summary: Get Org
      operationId: get_org_v1_identity_orgs__org_id__get
      parameters:
      - name: org_id
        in: path
        required: true
        schema:
          type: string
          title: Org Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/identity/orgs/{org_id}/members:
    post:
      tags:
      - identity
      summary: Add Agent To Org
      operationId: add_agent_to_org_v1_identity_orgs__org_id__members_post
      parameters:
      - name: org_id
        in: path
        required: true
        schema:
          type: string
          title: Org Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AddMemberRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/identity/orgs/{org_id}/members/{agent_id}:
    delete:
      tags:
      - identity
      summary: Remove Agent From Org
      operationId: remove_agent_from_org_v1_identity_orgs__org_id__members__agent_id__delete
      parameters:
      - name: org_id
        in: path
        required: true
        schema:
          type: string
          title: Org Id
      - name: agent_id
        in: path
        required: true
        schema:
          type: string
          title: Agent Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/identity/metrics/ingest:
    post:
      tags:
      - identity
      summary: Ingest Metrics
      operationId: ingest_metrics_v1_identity_metrics_ingest_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/IngestMetricsRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/identity/metrics:
    get:
      tags:
      - identity
      summary: Query Metrics
      operationId: query_metrics_v1_identity_metrics_get
      parameters:
      - name: agent_id
        in: query
        required: true
        schema:
          type: string
          title: Agent Id
      - name: metric_name
        in: query
        required: true
        schema:
          type: string
          title: Metric Name
      - name: since
        in: query
        required: false
        schema:
          anyOf:
          - type: number
          - type: 'null'
          title: Since
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          default: 100
          title: Limit
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/identity/metrics/deltas:
    get:
      tags:
      - identity
      summary: Get Metric Deltas
      operationId: get_metric_deltas_v1_identity_metrics_deltas_get
      parameters:
      - name: agent_id
        in: query
        required: true
        schema:
          type: string
          title: Agent Id
      - name: metric_name
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Metric Name
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/identity/metrics/averages:
    get:
      tags:
      - identity
      summary: Get Metric Averages
      operationId: get_metric_averages_v1_identity_metrics_averages_get
      parameters:
      - name: agent_id
        in: query
        required: true
        schema:
          type: string
          title: Agent Id
      - name: period
        in: query
        required: false
        schema:
          type: string
          default: 30d
          title: Period
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/infra/keys:
    get:
      tags:
      - infra
      summary: List Api Keys
      description: 'List API keys — admin only (fleet view).


        v1.2.4 audit P0-1: ``list_api_keys`` is now in

        ``ADMIN_ONLY_TOOLS`` so non-admin callers are rejected by

        ``require_tool`` with 403 ``admin_only``. Non-admin callers

        should use ``GET /v1/billing/keys`` for their own fleet.


        When called by an admin, returns keys for ALL agents (fleet

        view) because ownership is bypassed for admin tier.'
      operationId: list_api_keys_v1_infra_keys_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
    post:
      tags:
      - infra
      summary: Create Api Key Deprecated
      description: 'Deprecated: self-service key creation moved to /v1/billing/keys.'
      operationId: create_api_key_deprecated_v1_infra_keys_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /v1/infra/keys/revoke:
    post:
      tags:
      - infra
      summary: Revoke Api Key
      operationId: revoke_api_key_v1_infra_keys_revoke_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RevokeApiKeyRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/infra/keys/rotate:
    post:
      tags:
      - infra
      summary: Rotate Key
      operationId: rotate_key_v1_infra_keys_rotate_post
      parameters:
      - name: X-Rotate-Confirmation
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Rotate-Confirmation
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RotateKeyRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/infra/audit-log:
    get:
      tags:
      - infra
      summary: Get Global Audit Log
      operationId: get_global_audit_log_v1_infra_audit_log_get
      parameters:
      - name: since
        in: query
        required: false
        schema:
          anyOf:
          - type: number
          - type: 'null'
          title: Since
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          default: 100
          title: Limit
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/infra/databases/backups:
    get:
      tags:
      - infra
      summary: List Backups
      operationId: list_backups_v1_infra_databases_backups_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /v1/infra/databases/{database}/backup:
    post:
      tags:
      - infra
      summary: Backup Database
      operationId: backup_database_v1_infra_databases__database__backup_post
      parameters:
      - name: database
        in: path
        required: true
        schema:
          type: string
          title: Database
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
              - $ref: '#/components/schemas/BackupDatabaseRequest'
              - type: 'null'
              title: Body
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/infra/databases/{database}/restore:
    post:
      tags:
      - infra
      summary: Restore Database
      operationId: restore_database_v1_infra_databases__database__restore_post
      parameters:
      - name: database
        in: path
        required: true
        schema:
          type: string
          title: Database
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RestoreDatabaseRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/infra/databases/{database}/integrity:
    get:
      tags:
      - infra
      summary: Check Db Integrity
      operationId: check_db_integrity_v1_infra_databases__database__integrity_get
      parameters:
      - name: database
        in: path
        required: true
        schema:
          type: string
          title: Database
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/infra/webhooks:
    get:
      tags:
      - infra
      summary: List Webhooks
      operationId: list_webhooks_v1_infra_webhooks_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
    post:
      tags:
      - infra
      summary: Register Webhook
      operationId: register_webhook_v1_infra_webhooks_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RegisterWebhookRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/infra/webhooks/{webhook_id}/test:
    post:
      tags:
      - infra
      summary: Test Webhook
      operationId: test_webhook_v1_infra_webhooks__webhook_id__test_post
      parameters:
      - name: webhook_id
        in: path
        required: true
        schema:
          type: string
          title: Webhook Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/infra/webhooks/{webhook_id}:
    delete:
      tags:
      - infra
      summary: Delete Webhook
      operationId: delete_webhook_v1_infra_webhooks__webhook_id__delete
      parameters:
      - name: webhook_id
        in: path
        required: true
        schema:
          type: string
          title: Webhook Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/infra/webhooks/{webhook_id}/deliveries:
    get:
      tags:
      - infra
      summary: Get Webhook Deliveries
      operationId: get_webhook_deliveries_v1_infra_webhooks__webhook_id__deliveries_get
      parameters:
      - name: webhook_id
        in: path
        required: true
        schema:
          type: string
          title: Webhook Id
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          default: 50
          title: Limit
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          default: 0
          title: Offset
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/infra/events/schemas:
    post:
      tags:
      - infra
      summary: Register Event Schema
      operationId: register_event_schema_v1_infra_events_schemas_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RegisterEventSchemaRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/infra/events:
    post:
      tags:
      - infra
      summary: Publish Event
      operationId: publish_event_v1_infra_events_post
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PublishEventRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    get:
      tags:
      - infra
      summary: Get Events
      operationId: get_events_v1_infra_events_get
      parameters:
      - name: event_type
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Event Type
      - name: since_id
        in: query
        required: false
        schema:
          type: integer
          default: 0
          title: Since Id
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          default: 100
          title: Limit
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/infra/events/schemas/{event_type}:
    get:
      tags:
      - infra
      summary: Get Event Schema
      operationId: get_event_schema_v1_infra_events_schemas__event_type__get
      parameters:
      - name: event_type
        in: path
        required: true
        schema:
          type: string
          title: Event Type
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/marketplace/services:
    post:
      tags:
      - marketplace
      summary: Register Service
      operationId: register_service_v1_marketplace_services_post
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RegisterServiceRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    get:
      tags:
      - marketplace
      summary: Search Services
      operationId: search_services_v1_marketplace_services_get
      parameters:
      - name: query
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Query
      - name: category
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Category
      - name: tags
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Tags
      - name: max_cost
        in: query
        required: false
        schema:
          anyOf:
          - type: number
          - type: 'null'
          title: Max Cost
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          default: 20
          title: Limit
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          default: 0
          title: Offset
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/marketplace/services/{service_id}:
    get:
      tags:
      - marketplace
      summary: Get Service
      operationId: get_service_v1_marketplace_services__service_id__get
      parameters:
      - name: service_id
        in: path
        required: true
        schema:
          type: string
          title: Service Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    put:
      tags:
      - marketplace
      summary: Update Service
      operationId: update_service_v1_marketplace_services__service_id__put
      parameters:
      - name: service_id
        in: path
        required: true
        schema:
          type: string
          title: Service Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateServiceRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/marketplace/services/{service_id}/deactivate:
    post:
      tags:
      - marketplace
      summary: Deactivate Service
      operationId: deactivate_service_v1_marketplace_services__service_id__deactivate_post
      parameters:
      - name: service_id
        in: path
        required: true
        schema:
          type: string
          title: Service Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/marketplace/services/{service_id}/ratings:
    post:
      tags:
      - marketplace
      summary: Rate Service
      operationId: rate_service_v1_marketplace_services__service_id__ratings_post
      parameters:
      - name: service_id
        in: path
        required: true
        schema:
          type: string
          title: Service Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RateServiceRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    get:
      tags:
      - marketplace
      summary: Get Service Ratings
      operationId: get_service_ratings_v1_marketplace_services__service_id__ratings_get
      parameters:
      - name: service_id
        in: path
        required: true
        schema:
          type: string
          title: Service Id
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          default: 20
          title: Limit
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/marketplace/match:
    get:
      tags:
      - marketplace
      summary: Best Match
      operationId: best_match_v1_marketplace_match_get
      parameters:
      - name: query
        in: query
        required: true
        schema:
          type: string
          title: Query
      - name: budget
        in: query
        required: false
        schema:
          anyOf:
          - type: number
          - type: 'null'
          title: Budget
      - name: min_trust_score
        in: query
        required: false
        schema:
          anyOf:
          - type: number
          - type: 'null'
          title: Min Trust Score
      - name: prefer
        in: query
        required: false
        schema:
          type: string
          default: trust
          title: Prefer
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          default: 5
          title: Limit
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/marketplace/agents:
    get:
      tags:
      - marketplace
      summary: Search Agents
      operationId: search_agents_v1_marketplace_agents_get
      parameters:
      - name: query
        in: query
        required: true
        schema:
          type: string
          title: Query
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          default: 20
          title: Limit
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/marketplace/strategies:
    get:
      tags:
      - marketplace
      summary: List Strategies
      operationId: list_strategies_v1_marketplace_strategies_get
      parameters:
      - name: tags
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Tags
      - name: max_cost
        in: query
        required: false
        schema:
          anyOf:
          - type: number
          - type: 'null'
          title: Max Cost
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          default: 50
          title: Limit
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/marketplace/atlas/discover:
    post:
      tags:
      - marketplace
      summary: Atlas Discover
      operationId: atlas_discover_v1_marketplace_atlas_discover_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AtlasDiscoverRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/marketplace/atlas/preflight:
    post:
      tags:
      - marketplace
      summary: Atlas Preflight
      operationId: atlas_preflight_v1_marketplace_atlas_preflight_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AtlasPreflightRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/marketplace/atlas/broker:
    post:
      tags:
      - marketplace
      summary: Atlas Broker
      operationId: atlas_broker_v1_marketplace_atlas_broker_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AtlasBrokerRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/messaging/messages:
    post:
      tags:
      - messaging
      summary: Send Message
      operationId: send_message_v1_messaging_messages_post
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SendMessageRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    get:
      tags:
      - messaging
      summary: Get Messages
      operationId: get_messages_v1_messaging_messages_get
      parameters:
      - name: agent_id
        in: query
        required: true
        schema:
          type: string
          title: Agent Id
      - name: thread_id
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Thread Id
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          default: 50
          title: Limit
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          default: 0
          title: Offset
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/messaging/negotiations:
    post:
      tags:
      - messaging
      summary: Negotiate Price
      operationId: negotiate_price_v1_messaging_negotiations_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/NegotiatePriceRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/trust/servers:
    post:
      tags:
      - trust
      summary: Register Server
      operationId: register_server_v1_trust_servers_post
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RegisterServerRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    get:
      tags:
      - trust
      summary: Search Servers
      operationId: search_servers_v1_trust_servers_get
      parameters:
      - name: name_contains
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Name Contains
      - name: min_score
        in: query
        required: false
        schema:
          anyOf:
          - type: number
          - type: 'null'
          title: Min Score
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          default: 100
          title: Limit
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          default: 0
          title: Offset
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/trust/servers/{server_id}/score:
    get:
      tags:
      - trust
      summary: Get Trust Score
      operationId: get_trust_score_v1_trust_servers__server_id__score_get
      parameters:
      - name: server_id
        in: path
        required: true
        schema:
          type: string
          title: Server Id
      - name: window
        in: query
        required: false
        schema:
          type: string
          default: 24h
          title: Window
      - name: recompute
        in: query
        required: false
        schema:
          type: boolean
          default: false
          title: Recompute
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/trust/servers/{server_id}:
    put:
      tags:
      - trust
      summary: Update Server
      operationId: update_server_v1_trust_servers__server_id__put
      parameters:
      - name: server_id
        in: path
        required: true
        schema:
          type: string
          title: Server Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateServerRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    delete:
      tags:
      - trust
      summary: Delete Server
      operationId: delete_server_v1_trust_servers__server_id__delete
      parameters:
      - name: server_id
        in: path
        required: true
        schema:
          type: string
          title: Server Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/trust/servers/{server_id}/sla:
    get:
      tags:
      - trust
      summary: Check Sla Compliance
      operationId: check_sla_compliance_v1_trust_servers__server_id__sla_get
      parameters:
      - name: server_id
        in: path
        required: true
        schema:
          type: string
          title: Server Id
      - name: claimed_uptime
        in: query
        required: false
        schema:
          type: number
          default: 99.0
          title: Claimed Uptime
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/gatekeeper/jobs:
    post:
      tags:
      - gatekeeper
      summary: Submit Verification
      operationId: submit_verification_v1_gatekeeper_jobs_post
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SubmitVerificationRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    get:
      tags:
      - gatekeeper
      summary: List Verification Jobs
      operationId: list_verification_jobs_v1_gatekeeper_jobs_get
      parameters:
      - name: agent_id
        in: query
        required: true
        schema:
          type: string
          title: Agent Id
      - name: status
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Status
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 200
          minimum: 1
          default: 50
          title: Limit
      - name: cursor
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Cursor
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/gatekeeper/jobs/{job_id}:
    get:
      tags:
      - gatekeeper
      summary: Get Verification Status
      operationId: get_verification_status_v1_gatekeeper_jobs__job_id__get
      parameters:
      - name: job_id
        in: path
        required: true
        schema:
          type: string
          title: Job Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/gatekeeper/jobs/{job_id}/cancel:
    post:
      tags:
      - gatekeeper
      summary: Cancel Verification
      operationId: cancel_verification_v1_gatekeeper_jobs__job_id__cancel_post
      parameters:
      - name: job_id
        in: path
        required: true
        schema:
          type: string
          title: Job Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/gatekeeper/proofs/{proof_id}:
    get:
      tags:
      - gatekeeper
      summary: Get Proof
      operationId: get_proof_v1_gatekeeper_proofs__proof_id__get
      parameters:
      - name: proof_id
        in: path
        required: true
        schema:
          type: string
          title: Proof Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/gatekeeper/proofs/verify:
    post:
      tags:
      - gatekeeper
      summary: Verify Proof
      operationId: verify_proof_v1_gatekeeper_proofs_verify_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/VerifyProofRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /health:
    get:
      summary: ' Redirect Health'
      operationId: _redirect_health_health_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /pricing:
    get:
      summary: ' Redirect Pricing'
      operationId: _redirect_pricing_pricing_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /pricing/{tool}:
    get:
      summary: ' Redirect Pricing Tool'
      operationId: _redirect_pricing_tool_pricing__tool__get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /execute:
    post:
      summary: ' Redirect Execute'
      operationId: _redirect_execute_execute_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /v1/signing-key:
    get:
      summary: Signing Key
      operationId: signing_key_v1_signing_key_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
components:
  schemas:
    AddMemberRequest:
      properties:
        agent_id:
          type: string
          maxLength: 128
          title: Agent Id
        role:
          type: string
          title: Role
          default: member
      additionalProperties: false
      type: object
      required:
      - agent_id
      title: AddMemberRequest
      example:
        agent_id: agent-bob
        role: member
    AtlasBrokerRequest:
      properties:
        query:
          type: string
          maxLength: 500
          title: Query
        payer:
          type: string
          maxLength: 128
          pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{0,127}$
          title: Payer
        budget:
          anyOf:
          - type: number
            maximum: 1000000000.0
            minimum: 0.0
          - type: string
            pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
          - type: 'null'
          title: Budget
        min_trust_score:
          anyOf:
          - type: number
            maximum: 100.0
            minimum: 0.0
          - type: 'null'
          title: Min Trust Score
        prefer:
          type: string
          title: Prefer
          default: trust
        description:
          type: string
          maxLength: 2000
          title: Description
          default: ''
      additionalProperties: false
      type: object
      required:
      - query
      - payer
      title: AtlasBrokerRequest
      example:
        budget: 50.0
        description: Brokered analytics job
        payer: agent-alice
        query: data analysis
    AtlasDiscoverRequest:
      properties:
        query:
          type: string
          maxLength: 500
          title: Query
        budget:
          anyOf:
          - type: number
            maximum: 1000000000.0
            minimum: 0.0
          - type: string
            pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
          - type: 'null'
          title: Budget
        min_trust_score:
          anyOf:
          - type: number
            maximum: 100.0
            minimum: 0.0
          - type: 'null'
          title: Min Trust Score
        prefer:
          type: string
          title: Prefer
          default: trust
        capabilities:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Capabilities
        limit:
          type: integer
          maximum: 50.0
          minimum: 1.0
          title: Limit
          default: 5
      additionalProperties: false
      type: object
      required:
      - query
      title: AtlasDiscoverRequest
      example:
        budget: 10.0
        capabilities:
        - predict
        limit: 5
        min_trust_score: 50.0
        prefer: trust
        query: analytics
    AtlasPreflightRequest:
      properties:
        service_id:
          type: string
          maxLength: 256
          title: Service Id
        min_trust_score:
          anyOf:
          - type: number
            maximum: 100.0
            minimum: 0.0
          - type: 'null'
          title: Min Trust Score
        expected_cost:
          anyOf:
          - type: number
            maximum: 1000000000.0
            minimum: 0.0
          - type: string
            pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
          - type: 'null'
          title: Expected Cost
      additionalProperties: false
      type: object
      required:
      - service_id
      title: AtlasPreflightRequest
      example:
        expected_cost: 1.0
        min_trust_score: 60.0
        service_id: svc-abc123
    BackupDatabaseRequest:
      properties:
        encrypt:
          type: boolean
          title: Encrypt
          default: false
      additionalProperties: false
      type: object
      title: BackupDatabaseRequest
    BudgetCapRequest:
      properties:
        daily:
          anyOf:
          - type: number
          - type: string
            pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
          - type: 'null'
          title: Daily
        monthly:
          anyOf:
          - type: number
          - type: string
            pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
          - type: 'null'
          title: Monthly
        alert_threshold:
          type: number
          title: Alert Threshold
          default: 0.8
      additionalProperties: false
      type: object
      title: BudgetCapRequest
      example:
        alert_threshold: 0.8
        daily_cap: '100.00'
        monthly_cap: '2000.00'
    ConvertCurrencyRequest:
      properties:
        amount:
          anyOf:
          - type: number
            maximum: 1000000000.0
            exclusiveMinimum: 0.0
          - type: string
            pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,8}0*$
          title: Amount
        from_currency:
          type: string
          title: From Currency
        to_currency:
          type: string
          title: To Currency
      additionalProperties: false
      type: object
      required:
      - amount
      - from_currency
      - to_currency
      title: ConvertCurrencyRequest
      example:
        amount: '100.00'
        from_currency: CREDITS
        to_currency: USD
    CreateBillingApiKeyRequest:
      properties:
        tier:
          type: string
          title: Tier
          default: free
      additionalProperties: false
      type: object
      title: CreateBillingApiKeyRequest
      description: 'Self-service API key creation — v1.2.4 audit P0-1 successor

        of the former ``POST /v1/infra/keys``.'
      example:
        tier: free
    CreateEscrowRequest:
      properties:
        payer:
          type: string
          maxLength: 128
          pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{0,127}$
          title: Payer
        payee:
          type: string
          maxLength: 128
          pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{0,127}$
          title: Payee
        amount:
          anyOf:
          - type: number
            maximum: 1000000000.0
            exclusiveMinimum: 0.0
          - type: string
            pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,8}0*$
          title: Amount
        description:
          type: string
          maxLength: 2000
          title: Description
          default: ''
        currency:
          type: string
          title: Currency
          default: CREDITS
        timeout_hours:
          anyOf:
          - type: integer
          - type: 'null'
          title: Timeout Hours
        metadata:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Metadata
      additionalProperties: false
      type: object
      required:
      - payer
      - payee
      - amount
      title: CreateEscrowRequest
      example:
        amount: '50.00'
        description: Milestone delivery
        payee: agent-bob
        payer: agent-alice
        timeout_hours: 72
    CreateIntentRequest:
      properties:
        payer:
          type: string
          maxLength: 128
          pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{0,127}$
          title: Payer
        payee:
          type: string
          maxLength: 128
          pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{0,127}$
          title: Payee
        amount:
          anyOf:
          - type: number
            maximum: 1000000000.0
            exclusiveMinimum: 0.0
          - type: string
            pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,8}0*$
          title: Amount
        description:
          type: string
          maxLength: 2000
          title: Description
          default: ''
        currency:
          type: string
          title: Currency
          default: CREDITS
        metadata:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Metadata
        idempotency_key:
          anyOf:
          - type: string
            maxLength: 256
          - type: 'null'
          title: Idempotency Key
      additionalProperties: false
      type: object
      required:
      - payer
      - payee
      - amount
      title: CreateIntentRequest
      example:
        amount: '10.00'
        currency: CREDITS
        description: Data analysis service
        payee: agent-bob
        payer: agent-alice
    CreateOrgRequest:
      properties:
        org_name:
          type: string
          title: Org Name
        agent_id:
          type: string
          title: Agent Id
          default: ''
      additionalProperties: false
      type: object
      required:
      - org_name
      title: CreateOrgRequest
      example:
        agent_id: agent-alice
        org_name: Acme AI Agents
    CreatePerformanceEscrowRequest:
      properties:
        payer:
          type: string
          maxLength: 128
          pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{0,127}$
          title: Payer
        payee:
          type: string
          maxLength: 128
          pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{0,127}$
          title: Payee
        amount:
          anyOf:
          - type: number
            maximum: 1000000000.0
            exclusiveMinimum: 0.0
          - type: string
            pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,8}0*$
          title: Amount
        metric_name:
          type: string
          title: Metric Name
        threshold:
          type: string
          title: Threshold
        description:
          type: string
          maxLength: 2000
          title: Description
          default: ''
        conditions:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Conditions
      additionalProperties: false
      type: object
      required:
      - payer
      - payee
      - amount
      - metric_name
      - threshold
      title: CreatePerformanceEscrowRequest
      example:
        amount: '25.00'
        conditions:
          min_samples: 100
        description: ML model delivery
        metric_name: accuracy
        payee: agent-bob
        payer: agent-alice
        threshold: '>=0.95'
    CreateSplitIntentRequest:
      properties:
        payer:
          type: string
          maxLength: 128
          pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{0,127}$
          title: Payer
        amount:
          anyOf:
          - type: number
            maximum: 1000000000.0
            exclusiveMinimum: 0.0
          - type: string
            pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,8}0*$
          title: Amount
        splits:
          items:
            $ref: '#/components/schemas/SplitEntry'
          type: array
          title: Splits
        description:
          type: string
          maxLength: 2000
          title: Description
          default: ''
        currency:
          type: string
          title: Currency
          default: CREDITS
      additionalProperties: false
      type: object
      required:
      - payer
      - amount
      - splits
      title: CreateSplitIntentRequest
      example:
        amount: '100.00'
        description: Revenue split
        payer: agent-alice
        splits:
        - payee: agent-bob
          percentage: 60
        - payee: agent-carol
          percentage: 40
    CreateSubscriptionRequest:
      properties:
        payer:
          type: string
          maxLength: 128
          pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{0,127}$
          title: Payer
        payee:
          type: string
          maxLength: 128
          pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{0,127}$
          title: Payee
        amount:
          anyOf:
          - type: number
            maximum: 1000000000.0
            exclusiveMinimum: 0.0
          - type: string
            pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,8}0*$
          title: Amount
        interval:
          type: string
          title: Interval
        description:
          type: string
          maxLength: 2000
          title: Description
          default: ''
        currency:
          type: string
          title: Currency
          default: CREDITS
        metadata:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Metadata
      additionalProperties: false
      type: object
      required:
      - payer
      - payee
      - amount
      - interval
      title: CreateSubscriptionRequest
      example:
        amount: '9.99'
        description: Premium data feed
        interval: monthly
        payee: agent-bob
        payer: agent-alice
    CreateWalletRequest:
      properties:
        agent_id:
          type: string
          maxLength: 128
          pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{0,127}$
          title: Agent Id
        initial_balance:
          anyOf:
          - type: number
          - type: string
            pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
          title: Initial Balance
          default: '0'
        signup_bonus:
          type: boolean
          title: Signup Bonus
          default: true
      additionalProperties: false
      type: object
      required:
      - agent_id
      title: CreateWalletRequest
      example:
        agent_id: agent-alice
        initial_balance: '100.00'
        signup_bonus: true
    DepositRequest:
      properties:
        amount:
          anyOf:
          - type: number
            maximum: 1000000000.0
            exclusiveMinimum: 0.0
          - type: string
            pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,8}0*$
          title: Amount
        currency:
          type: string
          title: Currency
          default: CREDITS
        description:
          type: string
          maxLength: 2000
          title: Description
          default: ''
      additionalProperties: false
      type: object
      required:
      - amount
      title: DepositRequest
      example:
        amount: '50.00'
        currency: CREDITS
        description: Top-up via Stripe
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    IngestMetricsRequest:
      properties:
        agent_id:
          type: string
          maxLength: 128
          title: Agent Id
        metrics:
          additionalProperties: true
          type: object
          title: Metrics
        data_source:
          type: string
          title: Data Source
          default: self_reported
        signature:
          anyOf:
          - type: string
          - type: 'null'
          title: Signature
        nonce:
          anyOf:
          - type: string
          - type: 'null'
          title: Nonce
      additionalProperties: false
      type: object
      required:
      - agent_id
      - metrics
      title: IngestMetricsRequest
      example:
        agent_id: agent-alice
        data_source: self_reported
        metrics:
          requests_served: 15420
          uptime: 0.999
    MessageType:
      type: string
      enum:
      - text
      - price_negotiation
      - task_specification
      - counter_offer
      - accept
      - reject
      title: MessageType
    NegotiatePriceRequest:
      properties:
        initiator:
          type: string
          title: Initiator
        responder:
          type: string
          title: Responder
        amount:
          anyOf:
          - type: number
          - type: string
            pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
          title: Amount
        service_id:
          type: string
          title: Service Id
          default: ''
        expires_hours:
          type: integer
          title: Expires Hours
          default: 24
      additionalProperties: false
      type: object
      required:
      - initiator
      - responder
      - amount
      title: NegotiatePriceRequest
    OpenDisputeRequest:
      properties:
        escrow_id:
          type: string
          title: Escrow Id
        opener:
          type: string
          title: Opener
        reason:
          type: string
          title: Reason
          default: ''
      additionalProperties: false
      type: object
      required:
      - escrow_id
      - opener
      title: OpenDisputeRequest
    PartialCaptureRequest:
      properties:
        amount:
          anyOf:
          - type: number
            maximum: 1000000000.0
            exclusiveMinimum: 0.0
          - type: string
            pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,8}0*$
          title: Amount
      additionalProperties: false
      type: object
      required:
      - amount
      title: PartialCaptureRequest
      example:
        amount: '15.00'
    PropertySpecRequest:
      properties:
        name:
          type: string
          maxLength: 128
          title: Name
        scope:
          type: string
          title: Scope
          default: economic
        language:
          type: string
          pattern: ^(z3_smt2|json_policy)$
          title: Language
          default: z3_smt2
        expression:
          type: string
          maxLength: 1000000
          title: Expression
        description:
          type: string
          maxLength: 1000
          title: Description
          default: ''
      additionalProperties: false
      type: object
      required:
      - name
      - expression
      title: PropertySpecRequest
    PublishEventRequest:
      properties:
        event_type:
          type: string
          title: Event Type
        source:
          type: string
          title: Source
        payload:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Payload
      additionalProperties: false
      type: object
      required:
      - event_type
      - source
      title: PublishEventRequest
    RateServiceRequest:
      properties:
        rating:
          type: integer
          title: Rating
        review:
          type: string
          title: Review
          default: ''
      additionalProperties: false
      type: object
      required:
      - rating
      title: RateServiceRequest
    RefundSettlementRequest:
      properties:
        amount:
          anyOf:
          - type: number
            maximum: 1000000000.0
            exclusiveMinimum: 0.0
          - type: string
            pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,8}0*$
          - type: 'null'
          title: Amount
        reason:
          type: string
          maxLength: 2000
          title: Reason
          default: ''
      additionalProperties: false
      type: object
      title: RefundSettlementRequest
      example:
        amount: '10.00'
        reason: Service not delivered
    RegisterAgentRequest:
      properties:
        agent_id:
          type: string
          maxLength: 128
          title: Agent Id
        public_key:
          anyOf:
          - type: string
          - type: 'null'
          title: Public Key
        name:
          anyOf:
          - type: string
          - type: 'null'
          title: Name
        capabilities:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Capabilities
      additionalProperties: false
      type: object
      required:
      - agent_id
      title: RegisterAgentRequest
      example:
        agent_id: agent-alice
        name: Alice Agent
        public_key: ed25519:abc123...
    RegisterEventSchemaRequest:
      properties:
        event_type:
          type: string
          title: Event Type
        schema:
          additionalProperties: true
          type: object
          title: Schema
      additionalProperties: false
      type: object
      required:
      - event_type
      - schema
      title: RegisterEventSchemaRequest
    RegisterServerRequest:
      properties:
        name:
          type: string
          title: Name
        url:
          type: string
          title: Url
        transport_type:
          type: string
          title: Transport Type
          default: http
        server_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Server Id
      additionalProperties: false
      type: object
      required:
      - name
      - url
      title: RegisterServerRequest
    RegisterServiceRequest:
      properties:
        provider_id:
          type: string
          title: Provider Id
        name:
          type: string
          title: Name
        description:
          type: string
          title: Description
        category:
          type: string
          title: Category
        tools:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Tools
        tags:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Tags
        endpoint:
          type: string
          title: Endpoint
          default: ''
        pricing:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Pricing
      additionalProperties: false
      type: object
      required:
      - provider_id
      - name
      - description
      - category
      title: RegisterServiceRequest
    RegisterWebhookRequest:
      properties:
        url:
          type: string
          title: Url
        events:
          items:
            type: string
          type: array
          title: Events
        secret:
          type: string
          title: Secret
        filter_agent_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Filter Agent Ids
      additionalProperties: false
      type: object
      required:
      - url
      - events
      - secret
      title: RegisterWebhookRequest
    ResolveDisputeRequest:
      properties:
        resolution:
          type: string
          title: Resolution
        resolved_by:
          type: string
          title: Resolved By
        notes:
          type: string
          title: Notes
          default: ''
      additionalProperties: false
      type: object
      required:
      - resolution
      - resolved_by
      title: ResolveDisputeRequest
    RespondToDisputeRequest:
      properties:
        respondent:
          type: string
          title: Respondent
        response:
          type: string
          title: Response
      additionalProperties: false
      type: object
      required:
      - respondent
      - response
      title: RespondToDisputeRequest
    RestoreDatabaseRequest:
      properties:
        backup_path:
          anyOf:
          - type: string
          - type: 'null'
          title: Backup Path
        filename:
          anyOf:
          - type: string
          - type: 'null'
          title: Filename
        key:
          anyOf:
          - type: string
          - type: 'null'
          title: Key
        key_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Key Id
      additionalProperties: false
      type: object
      title: RestoreDatabaseRequest
      description: 'Restore from a previous backup.


        Either ``filename`` (preferred — matches what ``list_backups`` /

        ``backup_database`` now return) or ``backup_path`` (legacy — full

        path inside the backup dir) may be provided. ``filename`` is

        resolved server-side against ``A2A_DATA_DIR/backups`` so callers

        never need to know the absolute path.'
    RevokeApiKeyRequest:
      properties:
        key_hash_prefix:
          type: string
          title: Key Hash Prefix
      additionalProperties: false
      type: object
      required:
      - key_hash_prefix
      title: RevokeApiKeyRequest
    RotateKeyRequest:
      properties:
        current_key:
          type: string
          title: Current Key
      additionalProperties: false
      type: object
      required:
      - current_key
      title: RotateKeyRequest
    SendMessageRequest:
      properties:
        sender:
          type: string
          title: Sender
        recipient:
          type: string
          title: Recipient
        message_type:
          $ref: '#/components/schemas/MessageType'
        subject:
          type: string
          title: Subject
          default: ''
        body:
          type: string
          title: Body
          default: ''
        metadata:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Metadata
        thread_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Thread Id
      additionalProperties: false
      type: object
      required:
      - sender
      - recipient
      - message_type
      title: SendMessageRequest
    SplitEntry:
      properties:
        payee:
          type: string
          maxLength: 128
          pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{0,127}$
          title: Payee
        percentage:
          type: number
          title: Percentage
      additionalProperties: false
      type: object
      required:
      - payee
      - percentage
      title: SplitEntry
    SubmitMetricsRequest:
      properties:
        metrics:
          additionalProperties: true
          type: object
          title: Metrics
        data_source:
          type: string
          title: Data Source
          default: self_reported
      additionalProperties: false
      type: object
      required:
      - metrics
      title: SubmitMetricsRequest
      example:
        data_source: self_reported
        metrics:
          avg_response_ms: 245
          error_rate: 0.01
          uptime: 0.999
    SubmitVerificationRequest:
      properties:
        agent_id:
          type: string
          maxLength: 128
          title: Agent Id
        properties:
          items:
            $ref: '#/components/schemas/PropertySpecRequest'
          type: array
          maxItems: 100
          minItems: 1
          title: Properties
        scope:
          type: string
          title: Scope
          default: economic
        timeout_seconds:
          type: integer
          maximum: 900.0
          minimum: 10.0
          title: Timeout Seconds
          default: 300
        webhook_url:
          anyOf:
          - type: string
          - type: 'null'
          title: Webhook Url
        idempotency_key:
          anyOf:
          - type: string
          - type: 'null'
          title: Idempotency Key
        metadata:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Metadata
      additionalProperties: false
      type: object
      required:
      - agent_id
      - properties
      title: SubmitVerificationRequest
      example:
        agent_id: agent-alice
        properties:
        - name: balance_conservation
          scope: economic
          language: z3_smt2
          expression: '(declare-const x Int)

            (assert (> x 0))'
          description: Check positive balance
        scope: economic
        timeout_seconds: 300
    UpdateServerRequest:
      properties:
        name:
          anyOf:
          - type: string
          - type: 'null'
          title: Name
        url:
          anyOf:
          - type: string
          - type: 'null'
          title: Url
      additionalProperties: false
      type: object
      title: UpdateServerRequest
    UpdateServiceRequest:
      properties:
        name:
          anyOf:
          - type: string
          - type: 'null'
          title: Name
        description:
          anyOf:
          - type: string
          - type: 'null'
          title: Description
        category:
          anyOf:
          - type: string
          - type: 'null'
          title: Category
        tags:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Tags
        endpoint:
          anyOf:
          - type: string
          - type: 'null'
          title: Endpoint
        metadata:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Metadata
      additionalProperties: false
      type: object
      title: UpdateServiceRequest
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    VerifyAgentRequest:
      properties:
        message:
          type: string
          title: Message
        signature:
          type: string
          title: Signature
      additionalProperties: false
      type: object
      required:
      - message
      - signature
      title: VerifyAgentRequest
      example:
        message: challenge-nonce-12345
        signature: sig_hex_string...
    VerifyProofRequest:
      properties:
        proof_hash:
          type: string
          maxLength: 128
          title: Proof Hash
      additionalProperties: false
      type: object
      required:
      - proof_hash
      title: VerifyProofRequest
      example:
        proof_hash: a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2
    WithdrawRequest:
      properties:
        amount:
          anyOf:
          - type: number
            maximum: 1000000000.0
            exclusiveMinimum: 0.0
          - type: string
            pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,8}0*$
          title: Amount
        currency:
          type: string
          title: Currency
          default: CREDITS
        description:
          type: string
          maxLength: 2000
          title: Description
          default: ''
      additionalProperties: false
      type: object
      required:
      - amount
      title: WithdrawRequest
      example:
        amount: '25.00'
        currency: CREDITS
        description: Payout to external wallet
    HealthResponse:
      type: object
      properties:
        status:
          type: string
          description: Health status string.
          example: ok
        version:
          type: string
          description: Gateway version.
          example: 0.1.0
        timestamp:
          type: number
          description: Unix timestamp of the response.
      required:
      - status
    ExecuteRequest:
      type: object
      properties:
        tool:
          type: string
          description: Name of the tool to execute.
          example: get_balance
        params:
          type: object
          description: Parameters to pass to the tool.
          additionalProperties: true
          example:
            agent_id: agent-123
      required:
      - tool
      - params
    ExecuteResponse:
      type: object
      properties:
        tool:
          type: string
          description: Name of the tool that was executed.
        result:
          type: object
          description: Tool-specific result payload.
          additionalProperties: true
        cost:
          type: number
          description: Cost charged for this execution.
        balance_after:
          type: number
          description: Agent's wallet balance after execution.
      required:
      - tool
      - result
    ErrorResponse:
      type: object
      description: RFC 9457 Problem Details error response.
      properties:
        type:
          type: string
          format: uri
          description: URI reference identifying the problem type.
          example: https://api.greenhelix.net/errors/unknown-tool
        title:
          type: string
          description: Short human-readable summary of the problem type.
          example: Bad Request
        status:
          type: integer
          description: HTTP status code.
          example: 400
        detail:
          type: string
          description: Human-readable explanation specific to this occurrence.
          example: 'Unknown tool: nonexistent'
        instance:
          type: string
          description: URI reference identifying the specific occurrence.
          example: /v1/execute
      required:
      - type
      - title
      - status
      - detail
    GetBalanceOutput:
      type: object
      properties:
        balance:
          type: number
          description: Current wallet balance.
        currency:
          type: string
          description: Currency code (only present if non-default).
      required:
      - balance
    CreateIntentOutput:
      type: object
      properties:
        id:
          type: string
          description: Payment intent ID.
        status:
          type: string
          description: Intent status (e.g. pending, captured).
        payer:
          type: string
          description: Payer agent ID.
        payee:
          type: string
          description: Payee agent ID.
        amount:
          type: number
          description: Payment amount in atomic units.
      required:
      - id
      - status
      - payer
      - payee
      - amount
    GetPaymentHistoryOutput:
      type: object
      properties:
        history:
          type: array
          items:
            type: object
            properties:
              type:
                type: string
                description: Record type (intent, settlement, escrow).
              amount:
                type: number
                description: Payment amount.
              created_at:
                type: number
                description: Unix timestamp.
          description: List of payment history records.
      required:
      - history
    ToolPricing:
      type: object
      properties:
        name:
          type: string
          description: Tool name.
        service:
          type: string
          description: Service the tool belongs to.
        description:
          type: string
          description: What the tool does.
        pricing:
          type: object
          description: Pricing information.
          properties:
            per_call:
              type: number
              description: Cost per invocation.
        sla:
          type: object
          description: Service-level agreement.
          properties:
            max_latency_ms:
              type: integer
              description: Maximum expected latency in milliseconds.
        tier_required:
          type: string
          description: Minimum tier required to use this tool.
          enum:
          - free
          - starter
          - pro
          - enterprise
      required:
      - name
      - service
      - pricing
      - tier_required
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: API key passed as Bearer token in the Authorization header.
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: API key passed directly in the X-API-Key header (alternative to Bearer).
    X402Payment:
      type: apiKey
      in: header
      name: X-PAYMENT
      description: x402 payment proof for stateless authentication.
security:
- BearerAuth: []
- ApiKeyAuth: []
- X402Payment: []
servers:
- url: https://api.greenhelix.net
  description: Production (the host that serves this document at /v1/openapi.json; named by the agent card url, ai-plugin.json
    api.url, AGENTS.md and both SDK READMEs)
- url: https://sandbox.greenhelix.net
  description: 'Sandbox — identical surface, databases reset on every deploy (docs.html; probed 2026-09-19: /v1/health 200,
    same 1.4.10 build)'
x-api-evangelist:
  source: https://api.greenhelix.net/v1/openapi.json
  fetched: '2026-09-19'
  http_status: 200
  bytes: 123527
  original: openapi/_original/greenhelix-net-openapi.json
  changes: servers[], info.description and info.contact added (the served document declares none); nothing else altered.