API Evangelist conversational phrasing for Adobe Workfront Accesslevel API

# 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 Accesslevel API
  version: 1.0.0
extends: openapi/adobe-suite-accesslevel-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: 11
- target: $.paths['/accesslevel/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one access level
      effect: read
      questions:
      - How do I see the settings of a single Workfront access level?
      - Can I choose which fields to return for one access level?
      instructions:
      - text: Get access level {id}.
        slots:
          id: path.id
      - text: Fetch access level {id} with fields {fields}.
        slots:
          id: path.id
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accesslevel/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Edit an access level
      effect: write
      questions:
      - How do I change the permissions in one access level?
      - Can I update a single access level and get certain fields back?
      instructions:
      - text: Edit access level {id} with the changes I provide.
        slots:
          id: path.id
      - text: Update access level {id} and return {fields}.
        slots:
          id: path.id
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accesslevel/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an access level
      effect: destructive
      questions:
      - How do I delete an access level we no longer use?
      - Is there a force option when deleting an access level?
      instructions:
      - text: Delete access level {id}.
        slots:
          id: path.id
      - text: Force-delete access level {id} with force {force}.
        slots:
          id: path.id
          force: query.force
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accesslevel'].get
  update:
    x-apievangelist-phrasing:
      intent: Get several access levels by ID
      effect: read
      questions:
      - Can I fetch multiple access levels at once by their IDs?
      - What's the way to pull a known list of access levels together?
      instructions:
      - text: Get access levels {ids}.
        slots:
          ids: query.id
      - text: Bulk-fetch access levels {ids} with fields {fields}.
        slots:
          ids: query.id
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accesslevel'].put
  update:
    x-apievangelist-phrasing:
      intent: Edit many access levels at once
      effect: write
      questions:
      - Can I update several access levels in one request?
      - How do I bulk edit access levels?
      instructions:
      - text: Bulk edit the access levels I list with my changes.
      - text: Apply my edits to multiple access levels and return {fields}.
        slots:
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accesslevel'].post
  update:
    x-apievangelist-phrasing:
      intent: Create or copy an access level
      effect: write
      questions:
      - How do I create a new custom access level?
      - Can I make a new access level by copying an existing one?
      instructions:
      - text: Create an access level with the settings I give you.
      - text: Create an access level copied from {copySourceID}.
        slots:
          copySourceID: query.copySourceID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accesslevel'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete several access levels
      effect: destructive
      questions:
      - Can I delete a batch of access levels in one call?
      - What's the way to remove multiple access levels by ID?
      instructions:
      - text: Delete access levels {ids}.
        slots:
          ids: query.id
      - text: Bulk force-delete access levels {ids} with force {force}.
        slots:
          ids: query.id
          force: query.force
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accesslevel/replace'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace access levels with another one
      effect: destructive
      questions:
      - How do I retire access levels and move their users to a replacement level?
      - Can I swap several access levels for a single replacement?
      instructions:
      - text: Replace access levels {ids} with access level {replacementID}.
        slots:
          ids: query.id
          replacementID: query.replacementID
      - text: Retire {ids} and reassign everything to access level {replacementID}.
        slots:
          ids: query.id
          replacementID: query.replacementID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accesslevel/count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count access levels
      effect: read
      questions:
      - How many access levels are defined in our Workfront instance?
      - Can I count only the access levels matching a filter?
      instructions:
      - text: Count all access levels.
      - text: Count access levels matching {filters}.
        slots:
          filters: query.filters
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accesslevel/search'].get
  update:
    x-apievangelist-phrasing:
      intent: Search access levels
      effect: read
      questions:
      - What's the way to find access levels by name or other attributes?
      - Can I sort and page access level search results?
      instructions:
      - text: Search access levels where {filters}.
        slots:
          filters: query.filters
      - text: Search access levels for {filters} with {listOptions} and fields {fields}.
        slots:
          filters: query.filters
          listOptions: query.listOptions
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/accesslevel/report'].get
  update:
    x-apievangelist-phrasing:
      intent: Run an aggregate report on access levels
      effect: read
      questions:
      - Can I get a grouped summary report over access levels?
      - Which call aggregates access levels by a field?
      instructions:
      - text: Run an access level report filtered by {filters}.
        slots:
          filters: query.filters
      - text: Build an access level report for {filters} with {listOptions}.
        slots:
          filters: query.filters
          listOptions: query.listOptions
      method: generated
      generated: '2026-09-26'