# 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 Accessrequest API
  version: 1.0.0
extends: openapi/adobe-suite-access-request-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: 16
- target: $.paths['/accessrequest/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one access request
      effect: read
      questions:
      - How do I view the details of a single access request in Workfront?
      - Can I choose fields when reading one access request?
      instructions:
      - text: Show access request {id}.
        slots:
          id: path.id
      - text: Get access request {id} with fields {fields}.
        slots:
          id: path.id
          fields: query.fields
      method: generated
      generated: '2026-10-01'
- target: $.paths['/accessrequest/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an access request
      effect: write
      questions:
      - Can I change the details of an existing access request?
      - How do I edit a single access request by ID?
      instructions:
      - text: Update access request {id}.
        slots:
          id: path.id
      - text: Edit access request {id} and return {fields}.
        slots:
          id: path.id
          fields: query.fields
      method: generated
      generated: '2026-10-01'
- target: $.paths['/accessrequest/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an access request
      effect: destructive
      questions:
      - How do I delete one access request?
      - Can I force-delete an access request that has dependencies?
      instructions:
      - text: Delete access request {id}.
        slots:
          id: path.id
      - text: Force-delete access request {id} with force set to {force}.
        slots:
          id: path.id
          force: query.force
      method: generated
      generated: '2026-10-01'
- target: $.paths['/accessrequest'].get
  update:
    x-apievangelist-phrasing:
      intent: Fetch several access requests by ID
      effect: read
      questions:
      - Can I load multiple access requests in one call by their IDs?
      - Is there a bulk get for access requests?
      instructions:
      - text: Fetch access requests {id}.
        slots:
          id: query.id
      - text: Bulk-load access requests {id} with fields {fields}.
        slots:
          id: query.id
          fields: query.fields
      method: generated
      generated: '2026-10-01'
- target: $.paths['/accessrequest'].put
  update:
    x-apievangelist-phrasing:
      intent: Bulk update access requests
      effect: write
      questions:
      - How do I edit many access requests in a single request?
      - Can I apply changes to a batch of access requests at once?
      instructions:
      - text: Bulk-edit my access requests.
      - text: Apply a batch update to access requests and return {fields}.
        slots:
          fields: query.fields
      method: generated
      generated: '2026-10-01'
- target: $.paths['/accessrequest'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an access request
      effect: write
      questions:
      - How do I request access to an object in Workfront via the API?
      - Can I create a new access request record programmatically?
      instructions:
      - text: Create a new access request.
      - text: Submit an access request and return fields {fields}.
        slots:
          fields: query.fields
      method: generated
      generated: '2026-10-01'
- target: $.paths['/accessrequest'].delete
  update:
    x-apievangelist-phrasing:
      intent: Bulk delete access requests
      effect: destructive
      questions:
      - Can I delete several access requests at once by ID?
      - How do I remove a batch of access requests?
      instructions:
      - text: Delete access requests {id}.
        slots:
          id: query.id
      - text: Force-delete access requests {id} with force {force}.
        slots:
          id: query.id
          force: query.force
      method: generated
      generated: '2026-10-01'
- target: $.paths['/accessrequest/count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count access requests
      effect: read
      questions:
      - How many access requests match a filter?
      - Can I count pending access requests without listing them?
      instructions:
      - text: Count access requests matching {filters}.
        slots:
          filters: query.filters
      - text: Give me the total number of access requests.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/accessrequest/search'].get
  update:
    x-apievangelist-phrasing:
      intent: Search access requests
      effect: read
      questions:
      - What's the way to search access requests by field values?
      - Can I sort and page through access request search results?
      instructions:
      - text: Search access requests where {filters}.
        slots:
          filters: query.filters
      - text: Find access requests matching {filters} with list options {listOptions}.
        slots:
          filters: query.filters
          listOptions: query.listOptions
      method: generated
      generated: '2026-10-01'
- target: $.paths['/accessrequest/report'].get
  update:
    x-apievangelist-phrasing:
      intent: Run a report on access requests
      effect: read
      questions:
      - Can I get an aggregated report of access requests grouped by a field?
      - How do I summarize access requests rather than list them?
      instructions:
      - text: Run an access request report filtered by {filters}.
        slots:
          filters: query.filters
      - text: Build an access request report with options {listOptions}.
        slots:
          listOptions: query.listOptions
      method: generated
      generated: '2026-10-01'
- target: $.paths['/accessrequest/grantAccess'].put
  update:
    x-apievangelist-phrasing:
      intent: Approve an access request
      effect: write
      questions:
      - How do I grant the access someone asked for in their access request?
      - Can I approve a request but withhold certain actions?
      instructions:
      - text: Grant access request {accessRequestID}.
        slots:
          accessRequestID: query.accessRequestID
      - text: Approve access request {accessRequestID} with {actionType} access, forbidding {forbiddenActions}.
        slots:
          accessRequestID: query.accessRequestID
          actionType: query.actionType
          forbiddenActions: query.forbiddenActions
      method: generated
      generated: '2026-10-01'
- target: $.paths['/accessrequest/grantObjectAccess'].put
  update:
    x-apievangelist-phrasing:
      intent: Grant a user access to an object directly
      effect: write
      questions:
      - Can I share a specific Workfront object with a user without a pending request?
      - How do I give someone access to an object by its type and ID?
      instructions:
      - text: Grant {accessorID} access to {objCode} {id}.
        slots:
          accessorID: query.accessorID
          objCode: query.objCode
          id: query.id
      - text: Give {accessorID} {actionType} rights on {objCode} object {id}.
        slots:
          accessorID: query.accessorID
          actionType: query.actionType
          objCode: query.objCode
          id: query.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/accessrequest/ignore'].put
  update:
    x-apievangelist-phrasing:
      intent: Ignore an access request
      effect: write
      questions:
      - How do I dismiss an access request without granting it?
      - Can I ignore an access request someone sent me?
      instructions:
      - text: Ignore access request {accessRequestID}.
        slots:
          accessRequestID: query.accessRequestID
      - text: Dismiss access request {accessRequestID} without approving it.
        slots:
          accessRequestID: query.accessRequestID
      method: generated
      generated: '2026-10-01'
- target: $.paths['/accessrequest/recall'].put
  update:
    x-apievangelist-phrasing:
      intent: Recall an access request I sent
      effect: destructive
      questions:
      - Can I withdraw an access request I already submitted?
      - How do I take back my own pending access request?
      instructions:
      - text: Recall access request {accessRequestID}.
        slots:
          accessRequestID: query.accessRequestID
      - text: Withdraw my access request {accessRequestID}.
        slots:
          accessRequestID: query.accessRequestID
      method: generated
      generated: '2026-10-01'
- target: $.paths['/accessrequest/remind'].put
  update:
    x-apievangelist-phrasing:
      intent: Send a reminder about an access request
      effect: write
      questions:
      - How do I nudge the approver about a pending access request?
      - Can I resend a reminder for an access request?
      instructions:
      - text: Send a reminder for access request {accessRequestID}.
        slots:
          accessRequestID: query.accessRequestID
      - text: Remind the approver about access request {accessRequestID}.
        slots:
          accessRequestID: query.accessRequestID
      method: generated
      generated: '2026-10-01'
- target: $.paths['/accessrequest/myAccessRequests'].get
  update:
    x-apievangelist-phrasing:
      intent: List my access requests
      effect: read
      questions:
      - Which access requests have I submitted?
      - Can I filter the list of my own access requests?
      instructions:
      - text: List my access requests.
      - text: Show my access requests filtered by {filters}.
        slots:
          filters: query.filters
      method: generated
      generated: '2026-10-01'