# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Adobe Workfront Userapproval API
  version: 1.0.0
extends: openapi/adobe-suite-userapproval-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: 10
- target: $.paths['/userapproval/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a single user approval record
      effect: read
      questions:
      - How do I look up one Workfront user approval record by ID?
      - Can I pick which fields come back for a user approval?
      instructions:
      - text: Show me user approval {id}.
        slots:
          id: path.id
      - text: Get user approval {id} with only {fields}.
        slots:
          id: path.id
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/userapproval/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete one user approval record
      effect: destructive
      questions:
      - Can I delete a single user approval record?
      - Is there a force option when removing one user approval?
      instructions:
      - text: Delete user approval {id}.
        slots:
          id: path.id
      - text: Force-delete user approval {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/userapproval'].get
  update:
    x-apievangelist-phrasing:
      intent: Get several user approvals by ID
      effect: read
      questions:
      - Can I fetch several user approval records at once by ID?
      - Is there a bulk get for user approvals?
      instructions:
      - text: Fetch user approvals {id} in one call.
        slots:
          id: query.id
      - text: Bulk-get user approvals {id} returning {fields}.
        slots:
          id: query.id
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/userapproval'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a user approval record
      effect: write
      questions:
      - How do I create a new user approval record?
      - What fields come back after adding a user approval?
      instructions:
      - text: Create a new user approval record.
      - text: Add a user approval and return {fields}.
        slots:
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/userapproval'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete many user approval records
      effect: destructive
      questions:
      - Can I delete a list of user approval records in one call?
      - Is there a bulk delete for user approvals?
      instructions:
      - text: Bulk-delete user approvals {id}.
        slots:
          id: query.id
      - text: 'Force-delete all of these user approvals: {id}.'
        slots:
          id: query.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/userapproval/count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count user approval records
      effect: read
      questions:
      - How many user approval records are there?
      - Can I count only user approvals matching a filter?
      instructions:
      - text: Count all user approvals.
      - text: Count user approvals matching {filters}.
        slots:
          filters: query.filters
      method: generated
      generated: '2026-09-26'
- target: $.paths['/userapproval/search'].get
  update:
    x-apievangelist-phrasing:
      intent: Search user approval records
      effect: read
      questions:
      - Which user approval records are still waiting on a decision?
      - Can user approval search results be paged and trimmed to certain fields?
      instructions:
      - text: Search user approvals where {filters}.
        slots:
          filters: query.filters
      - text: Find user approvals matching {filters} showing only {fields}.
        slots:
          filters: query.filters
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/userapproval/report'].get
  update:
    x-apievangelist-phrasing:
      intent: Run a report on user approvals
      effect: read
      questions:
      - Can I get an aggregated report of user approval records?
      - What list options does the user approval report accept?
      instructions:
      - text: Run a user approval report.
      - text: Build a user approval report filtered by {filters}.
        slots:
          filters: query.filters
      method: generated
      generated: '2026-09-26'
- target: $.paths['/userapproval/approve'].put
  update:
    x-apievangelist-phrasing:
      intent: Approve pending users
      effect: write
      questions:
      - How do I approve users who are waiting for access?
      - Can I approve several pending users in one call?
      instructions:
      - text: Approve users {userIDs}.
        slots:
          userIDs: query.userIDs
      - text: Grant approval to the pending users {userIDs}.
        slots:
          userIDs: query.userIDs
      method: generated
      generated: '2026-09-26'
- target: $.paths['/userapproval/reject'].put
  update:
    x-apievangelist-phrasing:
      intent: Reject pending users
      effect: destructive
      questions:
      - How do I reject users who requested access?
      - Can I decline several pending users at once?
      instructions:
      - text: Reject users {userIDs}.
        slots:
          userIDs: query.userIDs
      - text: Decline the pending user requests for {userIDs}.
        slots:
          userIDs: query.userIDs
      method: generated
      generated: '2026-09-26'