# 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 Task API
  version: 1.0.0
extends: openapi/adobe-suite-task-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: 40
- target: $.paths['/task/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up a single Workfront task
      effect: read
      questions:
      - How do I pull the details of one Workfront task by its ID?
      - Can I choose which fields come back when I fetch a single task?
      instructions:
      - text: Show me task {id}.
        slots:
          id: path.id
      - text: Get task {id} with only the fields {fields}.
        slots:
          id: path.id
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/task/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update one task
      effect: write
      questions:
      - Can I change the name or dates on an existing task?
      - What's the call to edit one specific task in place?
      instructions:
      - text: Edit task {id} with the changes I give you.
        slots:
          id: path.id
      - text: Update the single task {id} and return the fields {fields}.
        slots:
          id: path.id
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/task/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete one task
      effect: destructive
      questions:
      - How do I remove a single task from a project?
      - Is there a way to force-delete a task that won't delete normally?
      instructions:
      - text: Delete task {id}.
        slots:
          id: path.id
      - text: Force delete task {id} using force={force}.
        slots:
          id: path.id
          force: query.force
      method: generated
      generated: '2026-09-26'
- target: $.paths['/task'].get
  update:
    x-apievangelist-phrasing:
      intent: Fetch several tasks by their IDs
      effect: read
      questions:
      - Can I retrieve a batch of tasks at once if I already know their IDs?
      - Which call returns multiple specific tasks in one request?
      instructions:
      - text: Fetch the tasks with IDs {id}.
        slots:
          id: query.id
      - text: Get tasks {id} in one call, returning only {fields}.
        slots:
          id: query.id
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/task'].put
  update:
    x-apievangelist-phrasing:
      intent: Update many tasks in one request
      effect: write
      questions:
      - Can I bulk edit a bunch of tasks together instead of one at a time?
      - Is there a bulk update for tasks, like reassigning due dates on many at once?
      instructions:
      - text: Bulk edit these tasks with the changes I list.
      - text: Apply my updates to many tasks at once and return {fields}.
        slots:
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/task'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a new task or copy an existing one
      effect: write
      questions:
      - How do I add a new task to a project in Workfront?
      - Can I create a task as a copy of another task?
      instructions:
      - text: Create a new task with the name and project I give you.
      - text: Make a copy of task {copySourceID} as a new task.
        slots:
          copySourceID: query.copySourceID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/task'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete many tasks at once
      effect: destructive
      questions:
      - Can I delete several tasks in a single request?
      - Is there a bulk delete for tasks by a list of IDs?
      instructions:
      - text: 'Delete all of these tasks: {id}.'
        slots:
          id: query.id
      - text: Bulk force delete tasks {id} with force={force}.
        slots:
          id: query.id
          force: query.force
      method: generated
      generated: '2026-09-26'
- target: $.paths['/task/count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count tasks matching filters
      effect: read
      questions:
      - How many tasks are there that match a given filter?
      - Can I get just a total number of tasks without pulling them all?
      instructions:
      - text: Count the tasks matching {filters}.
        slots:
          filters: query.filters
      - text: Tell me the total number of tasks in the system.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/task/search'].get
  update:
    x-apievangelist-phrasing:
      intent: Search tasks with filters
      effect: read
      questions:
      - How do I find tasks that are overdue or assigned to a certain person?
      - Can I search tasks by status and page through the results?
      instructions:
      - text: Search tasks where {filters}.
        slots:
          filters: query.filters
      - text: Find tasks matching {filters} and show the fields {fields}.
        slots:
          filters: query.filters
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/task/report'].get
  update:
    x-apievangelist-phrasing:
      intent: Run an aggregate report over tasks
      effect: read
      questions:
      - Can I get grouped or summed task data, like planned hours per project?
      - What call gives me a report-style aggregate of tasks rather than a list?
      instructions:
      - text: Run a task report grouped by {filters}.
        slots:
          filters: query.filters
      - text: Build an aggregate task report with options {listOptions}.
        slots:
          listOptions: query.listOptions
      method: generated
      generated: '2026-09-26'
- target: $.paths['/task/{id}/share'].put
  update:
    x-apievangelist-phrasing:
      intent: Share a task with a user, team or group
      effect: write
      questions:
      - How do I give a teammate view or manage access to one task?
      - Can I share a task but forbid certain actions like delete?
      instructions:
      - text: Share task {id} with {accessorObjCode} {accessorID} at {coreAction} access.
        slots:
          id: path.id
          accessorObjCode: query.accessorObjCode
          accessorID: query.accessorID
          coreAction: query.coreAction
      - text: Give {accessorID} ({accessorObjCode}) {coreAction} rights on task {id} but block {forbiddenActions}.
        slots:
          id: path.id
          accessorObjCode: query.accessorObjCode
          accessorID: query.accessorID
          coreAction: query.coreAction
          forbiddenActions: query.forbiddenActions
      method: generated
      generated: '2026-09-26'
- target: $.paths['/task/share'].put
  update:
    x-apievangelist-phrasing:
      intent: Share several tasks with someone at once
      effect: write
      questions:
      - Can I grant one person access to a whole list of tasks in a single call?
      - Is there a batch way to share many tasks with a team?
      instructions:
      - text: Share tasks {id} with {accessorObjCode} {accessorID} at {coreAction} level.
        slots:
          id: query.id
          accessorObjCode: query.accessorObjCode
          accessorID: query.accessorID
          coreAction: query.coreAction
      - text: Batch grant {coreAction} on tasks {id} to {accessorObjCode} {accessorID}, forbidding {forbiddenActions}.
        slots:
          id: query.id
          accessorObjCode: query.accessorObjCode
          accessorID: query.accessorID
          coreAction: query.coreAction
          forbiddenActions: query.forbiddenActions
      method: generated
      generated: '2026-09-26'
- target: $.paths['/task/{id}/unshare'].put
  update:
    x-apievangelist-phrasing:
      intent: Remove someone's shared access to a task
      effect: destructive
      questions:
      - How do I revoke a user's access to a task I shared with them?
      - Can I stop sharing one task with a specific team?
      instructions:
      - text: Unshare task {id} from {accessorObjCode} {accessorID}.
        slots:
          id: path.id
          accessorObjCode: query.accessorObjCode
          accessorID: query.accessorID
      - text: Revoke {accessorID}'s access to task {id}; they are a {accessorObjCode}.
        slots:
          id: path.id
          accessorID: query.accessorID
          accessorObjCode: query.accessorObjCode
      method: generated
      generated: '2026-09-26'
- target: $.paths['/task/unshare'].put
  update:
    x-apievangelist-phrasing:
      intent: Remove someone's access to several tasks
      effect: destructive
      questions:
      - Can I revoke one person's access to a list of tasks in one go?
      - Is there a batch unshare for many tasks?
      instructions:
      - text: Unshare tasks {id} from {accessorObjCode} {accessorID}.
        slots:
          id: query.id
          accessorObjCode: query.accessorObjCode
          accessorID: query.accessorID
      - text: Batch revoke access for {accessorID} ({accessorObjCode}) across tasks {id}.
        slots:
          id: query.id
          accessorID: query.accessorID
          accessorObjCode: query.accessorObjCode
      method: generated
      generated: '2026-09-26'
- target: $.paths['/task/{id}/sharePublic'].put
  update:
    x-apievangelist-phrasing:
      intent: Make a task publicly shared
      effect: write
      questions:
      - Can I make a task visible to everyone through a public share?
      - What access level can a public share of a task grant?
      instructions:
      - text: Publicly share task {id} with {coreAction} access.
        slots:
          id: path.id
          coreAction: query.coreAction
      - text: Open task {id} to the public at {coreAction}, forbidding {forbiddenActions}.
        slots:
          id: path.id
          coreAction: query.coreAction
          forbiddenActions: query.forbiddenActions
      method: generated
      generated: '2026-09-26'
- target: $.paths['/task/sharePublic'].put
  update:
    x-apievangelist-phrasing:
      intent: Publicly share several tasks at once
      effect: write
      questions:
      - Can I turn on public sharing for a whole list of tasks together?
      - Is there a batch public share for tasks?
      instructions:
      - text: Publicly share tasks {id} at {coreAction} level.
        slots:
          id: query.id
          coreAction: query.coreAction
      - text: Batch make tasks {id} public with {coreAction}, but block {forbiddenActions}.
        slots:
          id: query.id
          coreAction: query.coreAction
          forbiddenActions: query.forbiddenActions
      method: generated
      generated: '2026-09-26'
- target: $.paths['/task/{id}/unsharePublic'].put
  update:
    x-apievangelist-phrasing:
      intent: Turn off public sharing on a task
      effect: destructive
      questions:
      - How do I stop a task from being publicly shared?
      - Can I remove the public share from one task only?
      instructions:
      - text: Remove the public share from task {id}.
        slots:
          id: path.id
      - text: Make task {id} private again.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/task/unsharePublic'].put
  update:
    x-apievangelist-phrasing:
      intent: Turn off public sharing on several tasks
      effect: destructive
      questions:
      - Can I remove public sharing from many tasks in one request?
      - Is there a batch call to make a set of public tasks private?
      instructions:
      - text: Remove public sharing from tasks {id}.
        slots:
          id: query.id
      - text: Batch make tasks {id} private again.
        slots:
          id: query.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/task/acceptWork'].put
  update:
    x-apievangelist-phrasing:
      intent: Accept work on a task assigned to me
      effect: write
      questions:
      - How do I accept a task someone assigned to me?
      - Can I set a status when I accept work on a task?
      instructions:
      - text: Accept work on task {ID}.
        slots:
          ID: query.ID
      - text: Accept task {ID} and set its status to {status}.
        slots:
          ID: query.ID
          status: query.status
      method: generated
      generated: '2026-09-26'
- target: $.paths['/task/approveApproval'].put
  update:
    x-apievangelist-phrasing:
      intent: Approve a pending approval on a task
      effect: write
      questions:
      - How do I sign off on a task that is waiting for my approval?
      - Can I add an audit note when I approve a task?
      instructions:
      - text: Approve the pending approval on task {ID}.
        slots:
          ID: query.ID
      - text: Approve task {ID} with the note {auditNote} and email it.
        slots:
          ID: query.ID
          auditNote: query.auditNote
      method: generated
      generated: '2026-09-26'
- target: $.paths['/task/assign'].put
  update:
    x-apievangelist-phrasing:
      intent: Assign a task to a user, role or team
      effect: write
      questions:
      - How do I assign a task to one person or a job role?
      - Can I hand a task to a team instead of a specific user?
      instructions:
      - text: Assign task {ID} to {objCode} {objID}.
        slots:
          ID: query.ID
          objCode: query.objCode
          objID: query.objID
      - text: Give task {ID} to user {objID}.
        slots:
          ID: query.ID
          objID: query.objID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/task/assignMultiple'].put
  update:
    x-apievangelist-phrasing:
      intent: Assign a task to several people, roles or teams
      effect: write
      questions:
      - Can I put several users and roles on one task at once?
      - How do I assign multiple teams to the same task?
      instructions:
      - text: Assign task {ID} to users {userIDs}.
        slots:
          ID: query.ID
          userIDs: query.userIDs
      - text: Add roles {roleIDs} and teams {teamIDs} as assignees on task {ID}.
        slots:
          ID: query.ID
          roleIDs: query.roleIDs
          teamIDs: query.teamIDs
      method: generated
      generated: '2026-09-26'
- target: $.paths['/task/bulkCopy'].put
  update:
    x-apievangelist-phrasing:
      intent: Copy several tasks into a project
      effect: write
      questions:
      - Can I duplicate a group of tasks into another project?
      - How do I copy multiple tasks under a new parent task?
      instructions:
      - text: Copy tasks {taskIDs} into project {projectID}.
        slots:
          taskIDs: query.taskIDs
          projectID: query.projectID
      - text: Duplicate tasks {taskIDs} under parent task {parentID}.
        slots:
          taskIDs: query.taskIDs
          parentID: query.parentID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/task/bulkMove'].put
  update:
    x-apievangelist-phrasing:
      intent: Move several tasks to another project
      effect: write
      questions:
      - Can I move a batch of tasks from one project to another?
      - How do I relocate many tasks under a different parent at once?
      instructions:
      - text: Move tasks {taskIDs} into project {projectID}.
        slots:
          taskIDs: query.taskIDs
          projectID: query.projectID
      - text: Relocate tasks {taskIDs} so their parent becomes {parentID}.
        slots:
          taskIDs: query.taskIDs
          parentID: query.parentID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/task/calculateDataExtension'].put
  update:
    x-apievangelist-phrasing:
      intent: Recalculate custom fields on a task
      effect: write
      questions:
      - How do I refresh calculated custom form fields on one task?
      - Can I force a task's calculated data extension values to recompute?
      instructions:
      - text: Recalculate the custom fields on task {ID}.
        slots:
          ID: query.ID
      - text: Refresh calculated custom data for task {ID}.
        slots:
          ID: query.ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/task/calculateDataExtensions'].put
  update:
    x-apievangelist-phrasing:
      intent: Recalculate custom fields on many tasks
      effect: write
      questions:
      - Can I recompute calculated custom fields across a list of tasks?
      - Is there a bulk version of recalculating task custom data?
      instructions:
      - text: Recalculate custom fields on tasks {ids}.
        slots:
          ids: query.ids
      - text: 'Refresh calculated custom data for all of these tasks: {ids}.'
        slots:
          ids: query.ids
      method: generated
      generated: '2026-09-26'
- target: $.paths['/task/convertToProject'].put
  update:
    x-apievangelist-phrasing:
      intent: Convert a task into its own project
      effect: write
      questions:
      - A task grew too big — can I turn it into a full project?
      - When converting a task to a project, can I copy its categories over?
      instructions:
      - text: Convert task {ID} into a project.
        slots:
          ID: query.ID
      - text: Turn task {ID} into project {project} with exchange rate {exchangeRate}.
        slots:
          ID: query.ID
          project: query.project
          exchangeRate: query.exchangeRate
      method: generated
      generated: '2026-09-26'
- target: $.paths['/task/linkExternalObject'].put
  update:
    x-apievangelist-phrasing:
      intent: Link an external document or object to a task
      effect: write
      questions:
      - Can I attach a link to an external file or integration object on a task?
      - How do I connect a task to an item in another integrated system?
      instructions:
      - text: Link external object {linkedObjectID} to task {objID}.
        slots:
          objID: query.objID
          linkedObjectID: query.linkedObjectID
      - text: Attach {URL} to task {objID} via the {integrationType} integration.
        slots:
          objID: query.objID
          URL: query.URL
          integrationType: query.integrationType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/task/markDone'].put
  update:
    x-apievangelist-phrasing:
      intent: Mark a task as complete
      effect: write
      questions:
      - How do I mark a task as done?
      - Can I choose which completed status a task gets when I finish it?
      instructions:
      - text: Mark task {ID} done.
        slots:
          ID: query.ID
      - text: Complete task {ID} with status {status}.
        slots:
          ID: query.ID
          status: query.status
      method: generated
      generated: '2026-09-26'
- target: $.paths['/task/markNotDone'].put
  update:
    x-apievangelist-phrasing:
      intent: Reopen a completed task
      effect: write
      questions:
      - I marked a task complete by mistake — can I undo that?
      - Can I reopen a finished task for just one assignment?
      instructions:
      - text: Mark task {ID} as not done.
        slots:
          ID: query.ID
      - text: Reopen task {ID} for assignment {assignmentID}.
        slots:
          ID: query.ID
          assignmentID: query.assignmentID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/task/move'].put
  update:
    x-apievangelist-phrasing:
      intent: Move one task to another project
      effect: write
      questions:
      - How do I move a single task to a different project?
      - Can I nest one task under a different parent task?
      instructions:
      - text: Move task {ID} to project {projectID}.
        slots:
          ID: query.ID
          projectID: query.projectID
      - text: Put task {ID} under parent task {parentID}.
        slots:
          ID: query.ID
          parentID: query.parentID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/task/recallApproval'].put
  update:
    x-apievangelist-phrasing:
      intent: Recall a task approval request
      effect: write
      questions:
      - Can I pull back a task I submitted for approval?
      - How do I withdraw an approval request on a task before it's decided?
      instructions:
      - text: Recall the approval request on task {ID}.
        slots:
          ID: query.ID
      - text: Withdraw task {ID} from approval.
        slots:
          ID: query.ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/task/rejectApproval'].put
  update:
    x-apievangelist-phrasing:
      intent: Reject a pending approval on a task
      effect: write
      questions:
      - How do I reject a task that is awaiting my approval?
      - Can I leave a note explaining why I rejected a task approval?
      instructions:
      - text: Reject the approval on task {ID}.
        slots:
          ID: query.ID
      - text: Reject task {ID} with the note {auditNote}.
        slots:
          ID: query.ID
          auditNote: query.auditNote
      method: generated
      generated: '2026-09-26'
- target: $.paths['/task/replyToAssignment'].put
  update:
    x-apievangelist-phrasing:
      intent: Reply to a task assignment with a note
      effect: write
      questions:
      - Can I respond to a task assignment with a comment and a commit date?
      - How do I tell the requester when I'll finish an assigned task?
      instructions:
      - text: Reply to my assignment on task {ID} with {noteText}.
        slots:
          ID: query.ID
          noteText: query.noteText
      - text: Commit to finishing task {ID} by {commitDate}.
        slots:
          ID: query.ID
          commitDate: query.commitDate
      method: generated
      generated: '2026-09-26'
- target: $.paths['/task/unacceptWork'].put
  update:
    x-apievangelist-phrasing:
      intent: Undo accepting work on a task
      effect: write
      questions:
      - I accepted a task by accident — can I un-accept it?
      - What status does a task go back to when I unaccept the work?
      instructions:
      - text: Unaccept work on task {ID}.
        slots:
          ID: query.ID
      - text: Undo my acceptance of task {ID} and set status {status}.
        slots:
          ID: query.ID
          status: query.status
      method: generated
      generated: '2026-09-26'
- target: $.paths['/task/unassign'].put
  update:
    x-apievangelist-phrasing:
      intent: Remove a user from a task
      effect: write
      questions:
      - How do I take someone off a task?
      - Can I unassign one user without affecting other assignees?
      instructions:
      - text: Unassign user {userID} from task {ID}.
        slots:
          ID: query.ID
          userID: query.userID
      - text: Take {userID} off task {ID}.
        slots:
          ID: query.ID
          userID: query.userID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/task/unassignOccurrences'].put
  update:
    x-apievangelist-phrasing:
      intent: Remove a user from all occurrences of a recurring task
      effect: write
      questions:
      - Can I unassign someone from every occurrence of a recurring task?
      - How do I remove a user from the whole series of a repeating task?
      instructions:
      - text: Unassign {userID} from every occurrence of recurring task {ID}.
        slots:
          ID: query.ID
          userID: query.userID
      - text: Remove user {userID} from all repeats of task {ID}.
        slots:
          ID: query.ID
          userID: query.userID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/task/unlinkExternalObject'].put
  update:
    x-apievangelist-phrasing:
      intent: Unlink an external object from a task
      effect: destructive
      questions:
      - How do I remove a linked external document from a task?
      - Can I disconnect a task from an item in an integrated system?
      instructions:
      - text: Unlink external object {linkedObjectID} from task {objID}.
        slots:
          objID: query.objID
          linkedObjectID: query.linkedObjectID
      - text: Remove the {integrationType} link {linkedObjectID} on task {objID}.
        slots:
          objID: query.objID
          linkedObjectID: query.linkedObjectID
          integrationType: query.integrationType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/task/allTasksOnIterations'].get
  update:
    x-apievangelist-phrasing:
      intent: List all tasks in agile iterations
      effect: read
      questions:
      - Which tasks are planned in a given sprint or iteration?
      - Can I get every task across several agile iterations at once?
      instructions:
      - text: List all tasks on iterations {iterationIDs}.
        slots:
          iterationIDs: query.iterationIDs
      - text: Show me the sprint work in iteration {iterationIDs}.
        slots:
          iterationIDs: query.iterationIDs
      method: generated
      generated: '2026-09-26'
- target: $.paths['/task/defaultShownTimesheetTasks'].get
  update:
    x-apievangelist-phrasing:
      intent: List tasks shown by default on a timesheet
      effect: read
      questions:
      - Which tasks show up by default on my timesheet?
      - Can I see the default task rows for a particular timesheet?
      instructions:
      - text: List the default tasks on timesheet {timesheetID}.
        slots:
          timesheetID: query.timesheetID
      - text: Show which tasks timesheet {timesheetID} displays by default.
        slots:
          timesheetID: query.timesheetID
      method: generated
      generated: '2026-09-26'