# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for App Store Connect Devices API
  version: 1.0.0
extends: openapi/ios-devices-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: 4
- target: $.paths['/v1/devices'].get
  update:
    x-apievangelist-phrasing:
      intent: List registered devices
      effect: read
      questions:
      - Which test devices are registered on my developer account?
      - Can I filter devices by platform, status or UDID?
      - How do I find a device by its name?
      instructions:
      - text: List all my registered devices.
      - text: Find the device with UDID {udid}.
        slots:
          udid: query.filter[udid]
      - text: List devices with status {status}.
        slots:
          status: query.filter[status]
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/devices'].post
  update:
    x-apievangelist-phrasing:
      intent: Register a device
      effect: write
      questions:
      - How do I register a new test device for development?
      - Can I add a device UDID to my account through the API?
      instructions:
      - text: Register a device with {device_details}.
        slots:
          device_details: requestBody.data
      - text: Add a new test device using {device_details}.
        slots:
          device_details: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/devices/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a registered device
      effect: read
      questions:
      - What details are stored for one registered device?
      - How do I look up a device by its resource ID?
      instructions:
      - text: Fetch device {device_id}.
        slots:
          device_id: path.id
      - text: Show details of registered device {device_id}.
        slots:
          device_id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/devices/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Rename or disable a device
      effect: write
      questions:
      - How do I rename a registered device or disable it?
      - Can I change a device's status to free up a slot?
      instructions:
      - text: Update device {device_id} with {changes}.
        slots:
          device_id: path.id
          changes: requestBody.data
      - text: Disable registered device {device_id}.
        slots:
          device_id: path.id
      method: generated
      generated: '2026-10-01'