# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Unity Matchmaker Queues API
  version: 1.0.0
extends: openapi/unity-queues-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['/v3/projects/{projectId}/environments/{environmentId}/queues'].get
  update:
    x-apievangelist-phrasing:
      intent: List matchmaking queues
      effect: read
      questions:
      - Which matchmaking queues are set up in my environment?
      - What queues can players currently be matched through?
      instructions:
      - text: List matchmaking queues in project {projectId}, environment {environmentId}.
        slots:
          projectId: path.projectId
          environmentId: path.environmentId
      - text: Show all queues configured for environment {environmentId} of project {projectId}.
        slots:
          environmentId: path.environmentId
          projectId: path.projectId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/projects/{projectId}/environments/{environmentId}/queues'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a matchmaking queue
      effect: write
      questions:
      - How do I create a new matchmaking queue with its own pools?
      - Can I define escalation rules when setting up a queue?
      instructions:
      - text: Create matchmaking queue {name} in project {projectId}, environment {environmentId}.
        slots:
          name: requestBody.name
          projectId: path.projectId
          environmentId: path.environmentId
      - text: Add queue {name} with pools {pools} to environment {environmentId} of project {projectId}.
        slots:
          name: requestBody.name
          pools: requestBody.pools
          environmentId: path.environmentId
          projectId: path.projectId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/projects/{projectId}/environments/{environmentId}/queues/{queueName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a matchmaking queue's configuration
      effect: read
      questions:
      - What rules and pools does a particular matchmaking queue use?
      - Is a given queue currently enabled?
      instructions:
      - text: Show matchmaking queue {queueName} in project {projectId}, environment {environmentId}.
        slots:
          queueName: path.queueName
          projectId: path.projectId
          environmentId: path.environmentId
      - text: Get the configuration and status of queue {queueName} for environment {environmentId} of project {projectId}.
        slots:
          queueName: path.queueName
          environmentId: path.environmentId
          projectId: path.projectId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/projects/{projectId}/environments/{environmentId}/queues/{queueName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a matchmaking queue
      effect: write
      questions:
      - Can I temporarily disable a matchmaking queue?
      - Is it possible to change the escalation rules on an existing queue?
      instructions:
      - text: 'Disable queue {queueName} in project {projectId}, environment {environmentId} (enabled: {enabled}).'
        slots:
          queueName: path.queueName
          projectId: path.projectId
          environmentId: path.environmentId
          enabled: requestBody.enabled
      - text: Replace the pools of queue {queueName} in environment {environmentId}, project {projectId}, with {pools}.
        slots:
          queueName: path.queueName
          environmentId: path.environmentId
          projectId: path.projectId
          pools: requestBody.pools
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/projects/{projectId}/environments/{environmentId}/queues/{queueName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a matchmaking queue
      effect: destructive
      questions:
      - Can I remove a matchmaking queue I no longer use?
      - Does deleting a queue also remove its configuration?
      instructions:
      - text: Delete matchmaking queue {queueName} from project {projectId}, environment {environmentId}.
        slots:
          queueName: path.queueName
          projectId: path.projectId
          environmentId: path.environmentId
      - text: Remove queue {queueName} in environment {environmentId} of project {projectId}.
        slots:
          queueName: path.queueName
          environmentId: path.environmentId
          projectId: path.projectId
      method: generated
      generated: '2026-10-01'