# 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 Recent API
  version: 1.0.0
extends: openapi/adobe-suite-recent-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['/recent/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one recent-items entry by ID
      effect: read
      questions:
      - How do I look up a single entry in my recently viewed items?
      - Can I choose the fields returned for one recent item?
      instructions:
      - text: Show me recent item {id}.
        slots:
          id: path.id
      - text: Get recent entry {id} with only {fields}.
        slots:
          id: path.id
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/recent/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove an entry from recent items
      effect: destructive
      questions:
      - How do I clear one item out of my recents list?
      - Can I delete a single recently viewed entry?
      instructions:
      - text: Remove recent item {id} from my list.
        slots:
          id: path.id
      - text: Delete recent entry {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/recent'].get
  update:
    x-apievangelist-phrasing:
      intent: Fetch several recent-items entries by ID
      effect: read
      questions:
      - Can I load several recently viewed entries at once by ID?
      - Is there a batch lookup for recent items?
      instructions:
      - text: Fetch recent items {ids} together.
        slots:
          ids: query.id
      - text: Load recent entries {ids} including {fields}.
        slots:
          ids: query.id
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/recent'].post
  update:
    x-apievangelist-phrasing:
      intent: Add an entry to recent items
      effect: write
      questions:
      - How do I record an object in the recently viewed list?
      - Can I create a recent-items entry myself?
      instructions:
      - text: Add this object to my recent items.
      - text: Create a recent entry and return {fields}.
        slots:
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/recent'].delete
  update:
    x-apievangelist-phrasing:
      intent: Bulk remove recent-items entries
      effect: destructive
      questions:
      - Can I clear several entries from my recents at once?
      - Is there a bulk delete for recently viewed items?
      instructions:
      - text: Delete all of recent items {ids}.
        slots:
          ids: query.id
      - text: Clear the recent entries {ids} in one request.
        slots:
          ids: query.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/recent/count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count recent-items entries
      effect: read
      questions:
      - How many items are in my recently viewed list?
      - Can I count only recent entries matching a filter?
      instructions:
      - text: Count my recent items.
      - text: Tell me how many recent entries match {filters}.
        slots:
          filters: query.filters
      method: generated
      generated: '2026-09-26'
- target: $.paths['/recent/search'].get
  update:
    x-apievangelist-phrasing:
      intent: Search recently viewed items
      effect: read
      questions:
      - How do I find recently viewed items of a certain type?
      - Can I page and sort through my recent items?
      instructions:
      - text: Search recent items where {filters}.
        slots:
          filters: query.filters
      - text: Find recent entries matching {filters} and show {fields}.
        slots:
          filters: query.filters
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/recent/report'].get
  update:
    x-apievangelist-phrasing:
      intent: Run an aggregated report on recent items
      effect: read
      questions:
      - Can I get grouped report data about recently viewed items?
      - What report options summarize recent item activity?
      instructions:
      - text: Run a recent items report for {filters}.
        slots:
          filters: query.filters
      - text: Produce an aggregated recents report with options {options}.
        slots:
          options: query.listOptions
      method: generated
      generated: '2026-09-26'
- target: $.paths['/recent/updateLastViewedObject'].put
  update:
    x-apievangelist-phrasing:
      intent: Mark a recent item as just viewed
      effect: write
      questions:
      - How do I bump an item's last-viewed time in my recents?
      - Can I refresh when a recent object was last opened?
      instructions:
      - text: Update the last viewed time of recent item {recent}.
        slots:
          recent: query.ID
      - text: Mark recent entry {recent} as viewed just now.
        slots:
          recent: query.ID
      method: generated
      generated: '2026-09-26'