# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for REST Account Administration API
  version: 1.0.0
extends: openapi/gemini-trust-account-administration-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: 5
- target: $.paths['/v1/account'].post
  update:
    x-apievangelist-phrasing:
      intent: Get details about an exchange account
      effect: read
      questions:
      - Which users and country code are attached to my Gemini account?
      - Can I look up the details of one sub-account using a Master API key?
      instructions:
      - text: Show the account details, users and country code for account {account}.
        slots:
          account: requestBody.account
      - text: Pull up the detail record for the account my API key belongs to.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/account/create'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a new account in the master group
      effect: write
      questions:
      - How do I add a new sub-account to my master group with an API key?
      - Can a new account in my group be a custody account instead of an exchange account?
      instructions:
      - text: Create a new exchange account named {name} in my master group.
        slots:
          name: requestBody.name
      - text: Open a new {type} account called {name} under the master group.
        slots:
          type: requestBody.type
          name: requestBody.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/account/rename'].post
  update:
    x-apievangelist-phrasing:
      intent: Rename an account or change its shortname
      effect: write
      questions:
      - Can I change the display name of an existing account in my group?
      - Is it possible to give an account a new shortname without changing its name?
      instructions:
      - text: Rename account {account} to {newName}.
        slots:
          account: requestBody.account
          newName: requestBody.newName
      - text: Change the shortname of account {account} to {newAccount}.
        slots:
          account: requestBody.account
          newAccount: requestBody.newAccount
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/account/list'].post
  update:
    x-apievangelist-phrasing:
      intent: List the accounts in a master group
      effect: read
      questions:
      - What accounts exist under my master API key's group?
      - How many accounts can I list in one call for my group?
      instructions:
      - text: List every account in my master group.
      - text: Show the first {limit_accounts} accounts in the group.
        slots:
          limit_accounts: requestBody.limit_accounts
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/roles'].post
  update:
    x-apievangelist-phrasing:
      intent: Check which role an API key has
      effect: read
      questions:
      - What role is assigned to the API key I'm using?
      - Is my key a master-level or account-level key, and does it have the Trader role?
      instructions:
      - text: Tell me which roles API key {api_key} has been granted.
        slots:
          api_key: header.X-GEMINI-APIKEY
      - text: Check whether my current API key can trade, fund-manage or only audit.
      method: generated
      generated: '2026-10-01'