API Evangelist conversational phrasing for Token Sub Tpp API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Token Sub Tpp API
  version: 1.0.0
extends: openapi/token-io-subtpp-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: 9
- target: $.paths['/member/sub-tpps'].get
  update:
    x-apievangelist-phrasing:
      intent: List all sub-TPPs for the reseller
      effect: read
      questions:
      - Which sub-TPPs do I have, and what are their statuses?
      - Can I filter sub-TPPs by domicile country?
      instructions:
      - text: List all my sub-TPPs.
      - text: Show sub-TPPs domiciled in {countries} with statuses {statuses}.
        slots:
          countries: query.domicileCountries
          statuses: query.statuses
      method: generated
      generated: '2026-09-26'
- target: $.paths['/member/sub-tpps'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a new sub-TPP
      effect: write
      questions:
      - How do I create a sub-TPP with a name, domain and merchant category code?
      - Can a new sub-TPP sit under a parent sub-TPP?
      instructions:
      - text: Create a sub-TPP named {name} with domain {domain} and MCC {mcc}.
        slots:
          name: requestBody.name
          domain: requestBody.domain
          mcc: requestBody.mccCode
      - text: Create sub-TPP {name} in {country} under parent {parent_id}.
        slots:
          name: requestBody.name
          country: requestBody.domicileCountry
          parent_id: requestBody.parentSubTppId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/member/sub-tpps/{subTppId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get sub-TPP details
      effect: read
      questions:
      - What's on file for one of my sub-TPPs?
      - Can I fetch a single sub-TPP by id?
      instructions:
      - text: Get sub-TPP {sub_tpp_id}.
        slots:
          sub_tpp_id: path.subTppId
      - text: Show the details of sub-TPP {sub_tpp_id}.
        slots:
          sub_tpp_id: path.subTppId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/member/sub-tpps/{subTppId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a sub-TPP
      effect: write
      questions:
      - Can I change a sub-TPP's details after creating it?
      - What do I send to update a sub-TPP?
      instructions:
      - text: Update sub-TPP {sub_tpp_id} with {sub_tpp}.
        slots:
          sub_tpp_id: path.subTppId
          sub_tpp: requestBody.subTpp
      - text: Edit the details of sub-TPP {sub_tpp_id}.
        slots:
          sub_tpp_id: path.subTppId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/member/sub-tpps/{subTppId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a sub-TPP
      effect: destructive
      questions:
      - Can I delete a sub-TPP I no longer resell to?
      - Is deleting a sub-TPP permanent?
      instructions:
      - text: Delete sub-TPP {sub_tpp_id}.
        slots:
          sub_tpp_id: path.subTppId
      - text: Remove sub-TPP {sub_tpp_id}.
        slots:
          sub_tpp_id: path.subTppId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/member/sub-tpps/{subTppId}/children'].get
  update:
    x-apievangelist-phrasing:
      intent: List a sub-TPP's children
      effect: read
      questions:
      - Which sub-TPPs are children of another sub-TPP?
      - Can I see the nested sub-TPPs below one parent?
      instructions:
      - text: List the children of sub-TPP {sub_tpp_id}.
        slots:
          sub_tpp_id: path.subTppId
      - text: Show child sub-TPPs of {sub_tpp_id}.
        slots:
          sub_tpp_id: path.subTppId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/member/sub-tpps/{subTppId}/documents'].get
  update:
    x-apievangelist-phrasing:
      intent: List a sub-TPP's documents
      effect: read
      questions:
      - Which documents are uploaded for a sub-TPP?
      - Can I see only a sub-TPP's documents that are pending review?
      instructions:
      - text: List documents for sub-TPP {sub_tpp_id}.
        slots:
          sub_tpp_id: path.subTppId
      - text: Show sub-TPP {sub_tpp_id}'s documents with statuses {statuses}.
        slots:
          sub_tpp_id: path.subTppId
          statuses: query.statuses
      method: generated
      generated: '2026-09-26'
- target: $.paths['/member/sub-tpps/{subTppId}/documents/{documentId}/view'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a pre-signed URL for a sub-TPP document
      effect: read
      questions:
      - How do I view or download an uploaded sub-TPP document?
      - Can I get a temporary link to a sub-TPP's document?
      instructions:
      - text: Get a pre-signed URL for document {document_id} of sub-TPP {sub_tpp_id}.
        slots:
          document_id: path.documentId
          sub_tpp_id: path.subTppId
      - text: Give me a download link for sub-TPP {sub_tpp_id}'s document {document_id}.
        slots:
          sub_tpp_id: path.subTppId
          document_id: path.documentId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/member/sub-tpps/{subTppId}/upload-document/{documentId}'].post
  update:
    x-apievangelist-phrasing:
      intent: Upload a sub-TPP document
      effect: write
      questions:
      - How do I upload an onboarding document for a sub-TPP?
      - Which file types does a sub-TPP document upload accept?
      instructions:
      - text: Upload {file} for document {document_id} of sub-TPP {sub_tpp_id}.
        slots:
          file: requestBody.file
          document_id: path.documentId
          sub_tpp_id: path.subTppId
      - text: Attach a {file_type} file to sub-TPP {sub_tpp_id} document {document_id}.
        slots:
          file_type: requestBody.fileType
          sub_tpp_id: path.subTppId
          document_id: path.documentId
      method: generated
      generated: '2026-09-26'