# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for One Billing API
  version: 1.0.0
extends: openapi/integration-os-billing-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 2
- target: $.paths['/v1/billings/ai-agent-seats/trial'].get
  update:
    x-apievangelist-phrasing:
      intent: Check agent-seat free trial eligibility
      effect: read
      questions:
      - Am I still eligible for the free AI agent seat trial?
      - When does my agent-seat trial end?
      - How many free days does the One agent-seat trial offer?
      instructions:
      - text: Check whether my account can still start the agent-seat trial.
      - text: Tell me when my current agent-seat trial runs out.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/billings/ai-agent-seats/trial'].post
  update:
    x-apievangelist-phrasing:
      intent: Start the free agent-seat trial
      effect: write
      questions:
      - How do I start the one-time free trial for an AI agent seat?
      - What happens if I try to start the seat trial after already buying seats?
      instructions:
      - text: Open a checkout for the free agent-seat trial, returning to {success_url} on success.
        slots:
          success_url: requestBody.successUrl
      - text: Start my agent-seat trial with success URL {success_url} and cancel URL {cancel_url}.
        slots:
          success_url: requestBody.successUrl
          cancel_url: requestBody.cancelUrl
      method: generated
      generated: '2026-10-01'