# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Tray.ai Embedded Authentication API
  version: 1.0.0
extends: openapi/tray-ai-authentication-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: 2
- target: $.paths['/graphql'].get
  update:
    x-apievangelist-phrasing:
      intent: Open the embedded GraphQL playground
      effect: read
      questions:
      - Is there an interactive playground for exploring the Tray Embedded GraphQL API?
      - Can I try embedded queries in a browser while developing and testing?
      instructions:
      - text: Open the Tray.ai GraphQL playground so I can explore the embedded schema.
      - text: Load the interactive GraphQL explorer for testing embedded queries.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/graphql#authorize'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a user access token from a master token
      effect: write
      questions:
      - How do I get a user-scoped token for one of my embedded end users?
      - What token do I need before managing a user's solution instances and authentications?
      instructions:
      - text: Generate a user access token for end user {user} using my master token.
        slots:
          user: requestBody.variables
      - text: Run the authorize mutation {mutation} to mint a bearer token for a specific user.
        slots:
          mutation: requestBody.query
      method: generated
      generated: '2026-09-26'