# 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 Portaltab API
  version: 1.0.0
extends: openapi/adobe-suite-portaltab-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: 20
- target: $.paths['/portaltab/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a single portal tab
      effect: read
      questions:
      - How do I look up one Workfront portal tab by its ID?
      - Can I choose which fields come back when fetching a single portal tab?
      instructions:
      - text: Show me portal tab {id}.
        slots:
          id: path.id
      - text: Get portal tab {id} with only the fields {fields}.
        slots:
          id: path.id
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/portaltab/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Edit one portal tab
      effect: write
      questions:
      - Can I change the settings of one specific portal tab?
      - What's the way to rename or modify a single portal tab I already have?
      instructions:
      - text: Edit portal tab {id} with my changes.
        slots:
          id: path.id
      - text: Update portal tab {id} and return the fields {fields} afterwards.
        slots:
          id: path.id
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/portaltab/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete one portal tab
      effect: destructive
      questions:
      - How do I remove a single portal tab?
      - Is there a force option when deleting one portal tab?
      instructions:
      - text: Delete portal tab {id}.
        slots:
          id: path.id
      - text: Force-delete portal tab {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/portaltab'].get
  update:
    x-apievangelist-phrasing:
      intent: Get several portal tabs by ID
      effect: read
      questions:
      - Can I fetch several portal tabs at once by passing a list of IDs?
      - Is there a bulk get for portal tabs so I don't request them one by one?
      instructions:
      - text: Fetch the portal tabs with IDs {id} in one call.
        slots:
          id: query.id
      - text: Bulk-get portal tabs {id} returning fields {fields}.
        slots:
          id: query.id
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/portaltab'].put
  update:
    x-apievangelist-phrasing:
      intent: Edit many portal tabs at once
      effect: write
      questions:
      - Can I apply edits to a batch of portal tabs in a single request?
      - What's the bulk way to update multiple portal tabs together?
      instructions:
      - text: Bulk-edit these portal tabs with the changes I provide.
      - text: Apply my edits to several portal tabs and return {fields} for each.
        slots:
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/portaltab'].post
  update:
    x-apievangelist-phrasing:
      intent: Create or copy a portal tab
      effect: write
      questions:
      - How do I create a new portal tab?
      - Can I make a new portal tab as a copy of an existing one?
      instructions:
      - text: Create a new portal tab.
      - text: Create a portal tab copied from tab {copySourceID}.
        slots:
          copySourceID: query.copySourceID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/portaltab'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete many portal tabs at once
      effect: destructive
      questions:
      - Can I delete a whole list of portal tabs in one call?
      - What happens if I force a bulk delete of portal tabs?
      instructions:
      - text: Bulk-delete portal tabs {id}.
        slots:
          id: query.id
      - text: 'Force-delete all of these portal tabs: {id}.'
        slots:
          id: query.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/portaltab/count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count portal tabs
      effect: read
      questions:
      - How many portal tabs exist in our Workfront instance?
      - Can I count only the portal tabs that match a filter?
      instructions:
      - text: Count all portal tabs.
      - text: Count the portal tabs matching {filters}.
        slots:
          filters: query.filters
      method: generated
      generated: '2026-09-26'
- target: $.paths['/portaltab/search'].get
  update:
    x-apievangelist-phrasing:
      intent: Search portal tabs
      effect: read
      questions:
      - Which portal tabs match a name or other filter I have in mind?
      - Can search results for portal tabs be paged and limited to certain fields?
      instructions:
      - text: Search portal tabs where {filters}.
        slots:
          filters: query.filters
      - text: Find portal tabs matching {filters} and show only {fields}.
        slots:
          filters: query.filters
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/portaltab/report'].get
  update:
    x-apievangelist-phrasing:
      intent: Run a report on portal tabs
      effect: read
      questions:
      - Can I get an aggregated report across portal tabs?
      - What does the portal tab report return compared with a plain search?
      instructions:
      - text: Run a portal tab report.
      - text: Build a portal tab report filtered by {filters}.
        slots:
          filters: query.filters
      method: generated
      generated: '2026-09-26'
- target: $.paths['/portaltab/{id}/share'].put
  update:
    x-apievangelist-phrasing:
      intent: Share a portal tab with someone
      effect: write
      questions:
      - How do I share one portal tab with a specific user or team?
      - Can I grant view-only access to a portal tab while blocking certain actions?
      instructions:
      - text: Share portal tab {id} with {accessorObjCode} {accessorID} at {coreAction} access.
        slots:
          id: path.id
          accessorObjCode: query.accessorObjCode
          accessorID: query.accessorID
          coreAction: query.coreAction
      - text: Give user {accessorID} {coreAction} access to portal tab {id}, type {accessorObjCode}, but forbid {forbiddenActions}.
        slots:
          id: path.id
          accessorID: query.accessorID
          coreAction: query.coreAction
          accessorObjCode: query.accessorObjCode
          forbiddenActions: query.forbiddenActions
      method: generated
      generated: '2026-09-26'
- target: $.paths['/portaltab/share'].put
  update:
    x-apievangelist-phrasing:
      intent: Share several portal tabs at once
      effect: write
      questions:
      - Can I share a batch of portal tabs with the same person in one call?
      - Is there a bulk way to give a team access to multiple portal tabs?
      instructions:
      - text: Share portal tabs {id} with {accessorObjCode} {accessorID} at {coreAction} access.
        slots:
          id: query.id
          accessorObjCode: query.accessorObjCode
          accessorID: query.accessorID
          coreAction: query.coreAction
      - text: Batch-share tabs {id} to team {accessorID} ({accessorObjCode}) with {coreAction} rights.
        slots:
          id: query.id
          accessorID: query.accessorID
          accessorObjCode: query.accessorObjCode
          coreAction: query.coreAction
      method: generated
      generated: '2026-09-26'
- target: $.paths['/portaltab/{id}/unshare'].put
  update:
    x-apievangelist-phrasing:
      intent: Stop sharing a portal tab with someone
      effect: destructive
      questions:
      - How do I revoke one person's access to a single portal tab?
      - Can I unshare a portal tab from a specific team?
      instructions:
      - text: Unshare portal tab {id} from {accessorObjCode} {accessorID}.
        slots:
          id: path.id
          accessorObjCode: query.accessorObjCode
          accessorID: query.accessorID
      - text: Remove {accessorID}'s access to portal tab {id} (accessor type {accessorObjCode}).
        slots:
          accessorID: query.accessorID
          id: path.id
          accessorObjCode: query.accessorObjCode
      method: generated
      generated: '2026-09-26'
- target: $.paths['/portaltab/unshare'].put
  update:
    x-apievangelist-phrasing:
      intent: Stop sharing several portal tabs at once
      effect: destructive
      questions:
      - Can I pull someone's access from many portal tabs in one request?
      - Is there a batch unshare for portal tabs?
      instructions:
      - text: Unshare portal tabs {id} from {accessorObjCode} {accessorID}.
        slots:
          id: query.id
          accessorObjCode: query.accessorObjCode
          accessorID: query.accessorID
      - text: Batch-revoke {accessorID}'s access to tabs {id}, accessor type {accessorObjCode}.
        slots:
          accessorID: query.accessorID
          id: query.id
          accessorObjCode: query.accessorObjCode
      method: generated
      generated: '2026-09-26'
- target: $.paths['/portaltab/{id}/sharePublic'].put
  update:
    x-apievangelist-phrasing:
      intent: Share a portal tab publicly
      effect: write
      questions:
      - Can I make one portal tab visible to everyone?
      - What access level can a publicly shared portal tab carry?
      instructions:
      - text: Share portal tab {id} publicly with {coreAction} access.
        slots:
          id: path.id
          coreAction: query.coreAction
      - text: Make portal tab {id} public at {coreAction} but forbid {forbiddenActions}.
        slots:
          id: path.id
          coreAction: query.coreAction
          forbiddenActions: query.forbiddenActions
      method: generated
      generated: '2026-09-26'
- target: $.paths['/portaltab/sharePublic'].put
  update:
    x-apievangelist-phrasing:
      intent: Share several portal tabs publicly
      effect: write
      questions:
      - Can I make a batch of portal tabs public in one go?
      - Is there a bulk public-share for portal tabs?
      instructions:
      - text: Publicly share portal tabs {id} with {coreAction} access.
        slots:
          id: query.id
          coreAction: query.coreAction
      - text: Make tabs {id} public at {coreAction}, forbidding {forbiddenActions}.
        slots:
          id: query.id
          coreAction: query.coreAction
          forbiddenActions: query.forbiddenActions
      method: generated
      generated: '2026-09-26'
- target: $.paths['/portaltab/{id}/unsharePublic'].put
  update:
    x-apievangelist-phrasing:
      intent: Remove public sharing from a portal tab
      effect: destructive
      questions:
      - How do I make a public portal tab private again?
      - Can I turn off public access on just one portal tab?
      instructions:
      - text: Stop publicly sharing portal tab {id}.
        slots:
          id: path.id
      - text: Make portal tab {id} private again.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/portaltab/unsharePublic'].put
  update:
    x-apievangelist-phrasing:
      intent: Remove public sharing from several portal tabs
      effect: destructive
      questions:
      - Can I take a batch of portal tabs out of public view at once?
      - Is there a bulk way to revoke public access on portal tabs?
      instructions:
      - text: Remove public sharing from portal tabs {id}.
        slots:
          id: query.id
      - text: 'Make all of these public tabs private: {id}.'
        slots:
          id: query.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/portaltab/advancedCopy'].put
  update:
    x-apievangelist-phrasing:
      intent: Advanced-copy a portal tab under a new name
      effect: write
      questions:
      - Can I duplicate a portal tab with its contents under a new name?
      - What does the advanced copy of a portal tab let me carry over?
      instructions:
      - text: Advanced-copy portal tab {ID} as {newName}.
        slots:
          ID: query.ID
          newName: query.newName
      - text: Duplicate tab {ID} as {newName} including {advancedCopies}.
        slots:
          ID: query.ID
          newName: query.newName
          advancedCopies: query.advancedCopies
      method: generated
      generated: '2026-09-26'
- target: $.paths['/portaltab/exportDashboard'].put
  update:
    x-apievangelist-phrasing:
      intent: Export dashboards from a portal tab
      effect: write
      questions:
      - Can I export the dashboards that sit on a portal tab?
      - Which export options are available for a portal tab's dashboards?
      instructions:
      - text: Export the dashboards on portal tab {ID}.
        slots:
          ID: query.ID
      - text: Export dashboards {dashboardExports} from tab {ID} using options {dashboardExportOptions}.
        slots:
          dashboardExports: query.dashboardExports
          ID: query.ID
          dashboardExportOptions: query.dashboardExportOptions
      method: generated
      generated: '2026-09-26'