API Evangelist conversational phrasing for Adobe Workfront Acknowledgement 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 Acknowledgement API
  version: 1.0.0
extends: openapi/adobe-suite-acknowledgement-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: 13
- target: $.paths['/acknowledgement/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up one acknowledgement record
      effect: read
      questions:
      - How do I fetch a single acknowledgement record in Workfront by ID?
      - Can I limit which fields come back for one acknowledgement?
      instructions:
      - text: Show acknowledgement {id}.
        slots:
          id: path.id
      - text: Get acknowledgement {id} with fields {fields}.
        slots:
          id: path.id
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/acknowledgement/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update one acknowledgement record
      effect: write
      questions:
      - Can I edit an existing acknowledgement record directly?
      - What's the call to change a single acknowledgement by its ID?
      instructions:
      - text: Edit acknowledgement {id} with my changes.
        slots:
          id: path.id
      - text: Update acknowledgement {id} and return {fields}.
        slots:
          id: path.id
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/acknowledgement/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete one acknowledgement record
      effect: destructive
      questions:
      - How do I delete a single acknowledgement record?
      - Is there a force flag for deleting an acknowledgement?
      instructions:
      - text: Delete acknowledgement {id}.
        slots:
          id: path.id
      - text: Force delete acknowledgement {id} with force={force}.
        slots:
          id: path.id
          force: query.force
      method: generated
      generated: '2026-09-26'
- target: $.paths['/acknowledgement'].get
  update:
    x-apievangelist-phrasing:
      intent: Fetch several acknowledgements by ID
      effect: read
      questions:
      - Can I pull a batch of acknowledgement records if I have their IDs?
      - Which call returns multiple known acknowledgements in one request?
      instructions:
      - text: Fetch acknowledgements {id}.
        slots:
          id: query.id
      - text: Get the acknowledgement records {id} showing only {fields}.
        slots:
          id: query.id
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/acknowledgement'].put
  update:
    x-apievangelist-phrasing:
      intent: Update many acknowledgement records at once
      effect: write
      questions:
      - Is there a bulk edit for acknowledgement records?
      - Can I change a set of acknowledgements in a single request?
      instructions:
      - text: Bulk edit these acknowledgement records with my changes.
      - text: Apply updates to several acknowledgements and return {fields}.
        slots:
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/acknowledgement'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an acknowledgement record
      effect: write
      questions:
      - How do I create a new acknowledgement record directly?
      - What does the raw acknowledgement create call return?
      instructions:
      - text: Create a new acknowledgement record from the details I give.
      - text: Add an acknowledgement record and return {fields}.
        slots:
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/acknowledgement'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete many acknowledgement records
      effect: destructive
      questions:
      - Can I bulk delete acknowledgement records by ID?
      - Is there a way to remove several acknowledgements in one call?
      instructions:
      - text: Delete acknowledgements {id}.
        slots:
          id: query.id
      - text: Bulk force delete acknowledgement records {id} with force={force}.
        slots:
          id: query.id
          force: query.force
      method: generated
      generated: '2026-09-26'
- target: $.paths['/acknowledgement/count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count acknowledgement records
      effect: read
      questions:
      - How many acknowledgement records match a filter?
      - Can I get a count of acknowledgements without listing them?
      instructions:
      - text: Count acknowledgements matching {filters}.
        slots:
          filters: query.filters
      - text: Tell me how many acknowledgement records exist.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/acknowledgement/search'].get
  update:
    x-apievangelist-phrasing:
      intent: Search acknowledgement records
      effect: read
      questions:
      - How do I find acknowledgements for a particular object or user?
      - Can I search acknowledgement records with filters and paging?
      instructions:
      - text: Search acknowledgements where {filters}.
        slots:
          filters: query.filters
      - text: Find acknowledgement records matching {filters} with list options {listOptions}.
        slots:
          filters: query.filters
          listOptions: query.listOptions
      method: generated
      generated: '2026-09-26'
- target: $.paths['/acknowledgement/report'].get
  update:
    x-apievangelist-phrasing:
      intent: Run an aggregate report on acknowledgements
      effect: read
      questions:
      - Can I get grouped totals of acknowledgements rather than a list?
      - What gives me a report-style summary of acknowledgement records?
      instructions:
      - text: Run an acknowledgement report filtered by {filters}.
        slots:
          filters: query.filters
      - text: Summarize acknowledgements as a report using {listOptions}.
        slots:
          listOptions: query.listOptions
      method: generated
      generated: '2026-09-26'
- target: $.paths['/acknowledgement/acknowledge'].put
  update:
    x-apievangelist-phrasing:
      intent: Acknowledge an update or object
      effect: write
      questions:
      - How do I mark a notification or update as acknowledged?
      - Can I acknowledge a specific object, like an issue, by its type and ID?
      instructions:
      - text: Acknowledge {objCode} {objID}.
        slots:
          objCode: query.objCode
          objID: query.objID
      - text: Mark object {objID} as acknowledged.
        slots:
          objID: query.objID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/acknowledgement/acknowledgeMany'].put
  update:
    x-apievangelist-phrasing:
      intent: Acknowledge several objects at once
      effect: write
      questions:
      - Can I acknowledge a whole batch of updates in one call?
      - Is there a way to clear many unacknowledged items together?
      instructions:
      - text: 'Acknowledge all of these objects: {objCodeIDs}.'
        slots:
          objCodeIDs: query.objCodeIDs
      - text: Mark {objCodeIDs} acknowledged in one go.
        slots:
          objCodeIDs: query.objCodeIDs
      method: generated
      generated: '2026-09-26'
- target: $.paths['/acknowledgement/unacknowledge'].put
  update:
    x-apievangelist-phrasing:
      intent: Undo an acknowledgement
      effect: write
      questions:
      - I acknowledged something by mistake — can I unacknowledge it?
      - How do I mark an object as not acknowledged again?
      instructions:
      - text: Unacknowledge {objCode} {objID}.
        slots:
          objCode: query.objCode
          objID: query.objID
      - text: Remove my acknowledgement from object {objID}.
        slots:
          objID: query.objID
      method: generated
      generated: '2026-09-26'