# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Configuration Setup Subscribed Tenants API
  version: 1.0.0
extends: openapi/palo-alto-networks-subscribed-tenants-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: 4
- target: $.paths['/subscribed-tenants/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: List tenants subscribed to a snippet
      effect: read
      questions:
      - Which tenants are subscribed to a shared configuration snippet?
      - Can I see the subscribers for one snippet by its ID?
      instructions:
      - text: List subscribed tenants for snippet {id}.
        slots:
          id: path.id
      - text: Show which tenants subscribe to {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscribed-tenants'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a snippet's subscribed tenant
      effect: write
      questions:
      - Can I change the properties of a tenant's subscription to a snippet?
      - What do I need to update an existing snippet subscription?
      instructions:
      - text: Update the subscription of tenant {tsg_id} to snippet {snippet_id} ({snippet_name}).
        slots:
          tsg_id: requestBody.tsg_id
          snippet_id: requestBody.snippet_id
          snippet_name: requestBody.snippet_name
      - text: Set property {property} on tenant {tsg_id}'s subscription to snippet {snippet_id} named {snippet_name}.
        slots:
          property: requestBody.property
          tsg_id: requestBody.tsg_id
          snippet_id: requestBody.snippet_id
          snippet_name: requestBody.snippet_name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscribed-tenants'].post
  update:
    x-apievangelist-phrasing:
      intent: Subscribe a tenant to a snippet
      effect: write
      questions:
      - How do I subscribe a tenant to a shared snippet?
      - Can I add a new subscribed tenant to a configuration snippet?
      instructions:
      - text: Create a new subscribed tenant.
      - text: Add a tenant subscription to a shared snippet.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscribed-tenants'].delete
  update:
    x-apievangelist-phrasing:
      intent: Unsubscribe tenants from a snippet
      effect: destructive
      questions:
      - How do I remove tenants from a snippet subscription?
      - Can I unsubscribe several tenant service groups from one snippet at once?
      instructions:
      - text: Unsubscribe tenants {tsgs} from snippet {snippet-id}.
        slots:
          tsgs: query.tsgs
          snippet-id: query.snippet-id
      - text: Remove subscribed tenants {tsgs} on snippet {snippet-id}.
        slots:
          tsgs: query.tsgs
          snippet-id: query.snippet-id
      method: generated
      generated: '2026-09-26'