# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Elation Health Delegate Permissions API
  version: 1.0.0
extends: openapi/elation-health-delegate-permissions-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['/delegate_permissions/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a delegate permission (legacy)
      effect: read
      questions:
      - How do I see what a delegate is allowed to do for a physician, on the older endpoint?
      - Which legacy call returns one delegate permission by ID?
      instructions:
      - text: Get legacy delegate permission {id}.
        slots:
          id: path.id
      - text: Show the physician and permission type on older delegate grant {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/delegate_permissions/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a delegate permission (legacy)
      effect: write
      questions:
      - Can I change the permission type a delegate holds for a physician?
      - How do I reassign a delegate grant to another user on the older route?
      instructions:
      - text: Change legacy delegate permission {id} to permission type {permission_type}.
        slots:
          id: path.id
          permission_type: requestBody.permission_type
      - text: Reassign older delegate grant {id} to user {delegate_user} for physician {physician}.
        slots:
          id: path.id
          delegate_user: requestBody.delegate_user
          physician: requestBody.physician
      method: generated
      generated: '2026-09-26'
- target: $.paths['/delegate_permissions/'].get
  update:
    x-apievangelist-phrasing:
      intent: Find delegate permissions (legacy)
      effect: read
      questions:
      - Who has been granted delegate access to act for physicians, per the older endpoint?
      - Which legacy call lists every delegate permission?
      instructions:
      - text: Find all delegate permissions via the legacy route.
      - text: List older delegate access grants for my practice.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/delegate_permissions/'].post
  update:
    x-apievangelist-phrasing:
      intent: Grant a delegate permission (legacy)
      effect: write
      questions:
      - How do I let a staff member act on a physician's behalf through the unversioned route?
      - What does a legacy delegate grant need to specify?
      instructions:
      - text: Grant user {delegate_user} permission {permission_type} for physician {physician} using the legacy route.
        slots:
          delegate_user: requestBody.delegate_user
          permission_type: requestBody.permission_type
          physician: requestBody.physician
      - text: Create an older-style delegate grant in practice {practice}.
        slots:
          practice: requestBody.practice
      method: generated
      generated: '2026-09-26'
- target: $.paths['/delegate_permissions/'].delete
  update:
    x-apievangelist-phrasing:
      intent: Revoke a delegate permission (legacy)
      effect: destructive
      questions:
      - How do I revoke a delegate's access using the older delete call?
      - Which unversioned endpoint removes a delegate permission?
      instructions:
      - text: Revoke legacy delegate permission {id}.
        slots:
          id: path.id
      - text: Remove old delegate grant {id} via the unversioned route.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/delegate_permissions/'].get
  update:
    x-apievangelist-phrasing:
      intent: List delegate permissions with paging
      effect: read
      questions:
      - How do I page through delegate permissions in the v2.0 API?
      - Can I sort the /api/2.0 delegate permission list?
      instructions:
      - text: List v2.0 delegate permissions, {limit} per page.
        slots:
          limit: query.limit
      - text: Page through /api/2.0 delegate grants from offset {offset} ordered by {order_by}.
        slots:
          offset: query.offset
          order_by: query.order_by
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/delegate_permissions/'].post
  update:
    x-apievangelist-phrasing:
      intent: Grant a delegate permission in the v2.0 API
      effect: write
      questions:
      - What does /api/2.0 require to give a user delegate rights for a physician?
      - How do I authorize an assistant to act for a doctor in the v2.0 API?
      instructions:
      - text: Grant v2.0 delegate rights {permission_type} to user {delegate_user} for physician {physician} in practice {practice}.
        slots:
          permission_type: requestBody.permission_type
          delegate_user: requestBody.delegate_user
          physician: requestBody.physician
          practice: requestBody.practice
      - text: Authorize assistant {delegate_user} to act for doctor {physician} through /api/2.0.
        slots:
          delegate_user: requestBody.delegate_user
          physician: requestBody.physician
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/delegate_permissions/{id}/'].get
  update:
    x-apievangelist-phrasing:
      intent: Retrieve a delegate permission from v2.0
      effect: read
      questions:
      - How do I fetch one delegate permission by ID from /api/2.0?
      - Which user and physician does a v2.0 delegate grant cover?
      instructions:
      - text: Retrieve v2.0 delegate permission {id}.
        slots:
          id: path.id
      - text: Show who /api/2.0 delegate grant {id} covers.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/2.0/delegate_permissions/{id}/'].delete
  update:
    x-apievangelist-phrasing:
      intent: Revoke a delegate permission in the v2.0 API
      effect: destructive
      questions:
      - How do I revoke delegate access through /api/2.0?
      - Can I remove a v2.0 delegate grant when an assistant leaves?
      instructions:
      - text: Delete v2.0 delegate permission {id}.
        slots:
          id: path.id
      - text: Revoke /api/2.0 delegate grant {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'