# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for DocuSign Admin User Export API
  version: 1.0.0
extends: openapi/docusign-user-export-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['/v2/organizations/{organizationId}/exports/user_list'].get
  update:
    x-apievangelist-phrasing:
      intent: List user list export requests
      effect: read
      questions:
      - Which user list exports have I requested for my organization?
      - Can I see pending and completed user exports together?
      instructions:
      - text: List user list export requests for organization {organization}.
        slots:
          organization: path.organizationId
      - text: Show pending user exports in organization {organization}.
        slots:
          organization: path.organizationId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/organizations/{organizationId}/exports/user_list'].post
  update:
    x-apievangelist-phrasing:
      intent: Request a user list export
      effect: write
      questions:
      - How do I export a list of all users in my organization?
      - Can I export users for specific accounts or domains only?
      instructions:
      - text: Start a user list export of type {type} for organization {organization}.
        slots:
          type: requestBody.type
          organization: path.organizationId
      - text: Export users in accounts {accounts} for organization {organization}.
        slots:
          accounts: requestBody.accounts
          organization: path.organizationId
      - text: Export users on domains {domains} for organization {organization}.
        slots:
          domains: requestBody.domains
          organization: path.organizationId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/organizations/{organizationId}/exports/user_list/{exportId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a user list export's results
      effect: read
      questions:
      - Is my user list export ready to download?
      - Where do I get the results of a single user export?
      instructions:
      - text: Get the results of user export {export} in organization {organization}.
        slots:
          export: path.exportId
          organization: path.organizationId
      - text: Check if user export {export} is finished.
        slots:
          export: path.exportId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/organizations/{organizationId}/exports/user_list/{exportId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a user list export request
      effect: destructive
      questions:
      - How do I delete a user export request I no longer need?
      - Can I cancel a pending user list export?
      instructions:
      - text: Delete user export {export} in organization {organization}.
        slots:
          export: path.exportId
          organization: path.organizationId
      - text: Remove export request {export}.
        slots:
          export: path.exportId
      method: generated
      generated: '2026-10-01'