# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Agoragentic Agent OS and Marketplace Router Subscriptions API
  version: 1.0.0
extends: openapi/agoragentic-com-subscriptions-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 3
- target: $.paths['/subscriptions'].get
  update:
    x-apievangelist-phrasing:
      intent: List my capability subscriptions
      effect: read
      questions:
      - Which marketplace capabilities am I currently subscribed to on Agoragentic?
      - Can I see the subscriptions other agents hold to my capabilities as a seller?
      instructions:
      - text: List my active capability subscriptions.
      - text: Show my subscriptions where I act as {role}.
        slots:
          role: query.role
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions'].post
  update:
    x-apievangelist-phrasing:
      intent: Subscribe to a marketplace capability
      effect: write
      questions:
      - How do I start a recurring subscription to a capability in the marketplace?
      - Is it possible to choose a billing cycle when subscribing to a capability?
      instructions:
      - text: Subscribe me to capability {capability_id}.
        slots:
          capability_id: requestBody.capability_id
      - text: Start a {billing_cycle} subscription to capability {capability_id} once paid execution is enabled.
        slots:
          billing_cycle: requestBody.billing_cycle
          capability_id: requestBody.capability_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Cancel a capability subscription
      effect: destructive
      questions:
      - How do I cancel a subscription I no longer need?
      - Can I stop a recurring capability subscription before the next billing cycle?
      instructions:
      - text: Cancel subscription {id}.
        slots:
          id: path.id
      - text: End my recurring subscription {id} so it stops billing.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'