Adobe Suite Optask API

The Optask API from Adobe Suite — 36 operation(s) for optask.

Documentation GitHub OpenAPI

Operations 41

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /optask/{id} Get one Workfront issue by ID · Get for OpTask #

Ask an LLM

“How do I fetch a single Workfront issue when I already know its ID?”

“Can I choose which fields come back when reading one issue?”

Tell an agent

Show me issue {id}.

Get issue {id} with only the fields {fields}.

PUT /optask/{id} Edit a single issue · Edit a OpTask #

Ask an LLM

“What call changes the fields on one specific issue?”

“Can I update just one issue without touching the others?”

Tell an agent

Update issue {id} with my changes.

Edit issue {id} and return the fields {fields} afterwards.

DELETE /optask/{id} Delete a single issue · Delete for OpTask #

Ask an LLM

“How do I delete one issue by its ID?”

“Is there a way to force-delete an issue that has dependent objects?”

Tell an agent destructive · confirm first

Delete issue {id}.

Force delete issue {id} with force set to {force}.

GET /optask Get several issues by their IDs · Bulk Get for OpTask #

Ask an LLM

“Can I load a batch of issues in one request if I have a list of IDs?”

“Which call returns multiple specific issues at once?”

Tell an agent

Fetch the issues with IDs {id}.

Bulk get issues {id} returning the fields {fields}.

PUT /optask Bulk edit many issues at once · Bulk Edit for OpTask #

Ask an LLM

“How do I apply the same change to lots of issues in one request?”

“Is there a bulk update for issues instead of editing them one by one?”

Tell an agent

Bulk update this batch of issues with the edits I give you.

Bulk edit these issues and return the fields {fields}.

POST /optask Create or copy an issue · Create or copy a optask #

Ask an LLM

“How do I log a new issue in Adobe Workfront through the API?”

“Can I create an issue by copying an existing one?”

Tell an agent

Create a new issue with the details I provide.

Create a new issue as a copy of issue {copySourceID}.

DELETE /optask Bulk delete several issues · Bulk Delete for OpTask #

Ask an LLM

“Can I delete a whole list of issues in a single call?”

“What happens if I need to force-delete multiple issues together?”

Tell an agent destructive · confirm first

Delete all of these issues: {id}.

Bulk force delete issues {id} with force {force}.

GET /optask/count Count issues matching a filter · Count of optask #

Ask an LLM

“How many issues match a given filter?”

“Can I get just a count of open issues without pulling the records?”

Tell an agent

Count the issues that match {filters}.

Tell me the total number of issues.

GET /optask/search Search issues with filters · Search of optask #

Ask an LLM

“How do I find issues that match certain criteria?”

“Can I sort and page through issue search results?”

Tell an agent

Search issues where {filters}.

Search issues matching {filters} using list options {listOptions}.

GET /optask/report Run an aggregate report on issues · Report of optask #

Ask an LLM

“Can I get grouped or aggregated report data about issues?”

“What returns a report of issues rather than the raw records?”

Tell an agent

Run an issue report filtered by {filters}.

Build a report on issues grouped using list options {listOptions}.

PUT /optask/{id}/share Share one issue with a user or group · Sharing of a OpTask #

Ask an LLM

“How do I give a specific user access to one issue?”

“Can I share an issue but forbid some actions like deleting it?”

Tell an agent

Share issue {id} with {accessorObjCode} {accessorID} granting {coreAction} access.

Share issue {id} with user {accessorID} as {accessorObjCode} at level {coreAction}, forbidding {forbiddenActions}.

PUT /optask/share Share several issues with one accessor · Batch sharing of a OpTask #

Ask an LLM

“Can I grant a team access to a batch of issues in one request?”

“Which call shares multiple issues with the same person at once?”

Tell an agent

Share issues {id} with {accessorObjCode} {accessorID} at {coreAction} access.

Batch share issues {id} with team {accessorID} ({accessorObjCode}) as {coreAction} but forbid {forbiddenActions}.

PUT /optask/{id}/unshare Remove someone's access to one issue · Un-sharing of a OpTask #

Ask an LLM

“How do I stop sharing a single issue with a user?”

“Can I revoke one team's access to an issue I shared earlier?”

Tell an agent destructive · confirm first

Unshare issue {id} from {accessorObjCode} {accessorID}.

Revoke user {accessorID}'s access to issue {id} (accessor type {accessorObjCode}).

PUT /optask/unshare Remove someone's access to several issues · Batch un-sharing of a OpTask #

Ask an LLM

“Can I revoke a user's access to many issues in one go?”

“What un-shares a batch of issues from the same accessor?”

Tell an agent destructive · confirm first

Unshare issues {id} from {accessorObjCode} {accessorID}.

Batch revoke access for {accessorID} ({accessorObjCode}) on all of issues {id}.

PUT /optask/{id}/sharePublic Make one issue publicly shared · Public share of a OpTask #

Ask an LLM

“How do I share an issue publicly instead of with named users?”

“Can a public share of an issue be limited to view-only?”

Tell an agent

Share issue {id} publicly with {coreAction} access.

Publicly share issue {id} at {coreAction} while forbidding {forbiddenActions}.

PUT /optask/sharePublic Publicly share several issues · Batch public share of a OpTask #

Ask an LLM

“Can I make a whole set of issues public in one request?”

“Which call applies a public share to multiple issues together?”

Tell an agent

Publicly share issues {id} with {coreAction} access.

Batch public share issues {id} at {coreAction}, forbidding {forbiddenActions}.

PUT /optask/{id}/unsharePublic Turn off public sharing on one issue · Public un-share of a OpTask #

Ask an LLM

“How do I make a publicly shared issue private again?”

“Can I remove the public link from a single issue?”

Tell an agent destructive · confirm first

Stop publicly sharing issue {id}.

Remove the public share from issue {id}.

PUT /optask/unsharePublic Turn off public sharing on several issues · Batch public un-share of a OpTask #

Ask an LLM

“Can I pull public access from many issues at once?”

“What removes public shares from a batch of issues?”

Tell an agent destructive · confirm first

Remove public sharing from issues {id}.

Batch un-share issues {id} from the public.

PUT /optask/acceptWork Accept work on an issue · Op task accept work #

Ask an LLM

“How do I accept an issue that was assigned to me?”

“Can I set a status when I accept work on an issue?”

Tell an agent

Accept the work on issue {ID}.

Accept work on issue {ID} and set its status to {status}.

PUT /optask/approveApproval Approve an issue's pending approval · Op task approve approval #

Ask an LLM

“How do I approve an issue that is waiting on my approval?”

“Can I add an audit note and email it when approving an issue?”

Tell an agent

Approve the pending approval on issue {ID}.

Approve issue {ID} with the note {auditNote} and email it to the reviewers.

PUT /optask/assign Assign an issue to a user, role or team · Op task assign #

Ask an LLM

“How do I assign an issue to a single person or team?”

“Can an issue be assigned to a job role instead of a user?”

Tell an agent

Assign issue {ID} to {objCode} {objID}.

Give issue {ID} to user {objID}.

PUT /optask/assignMultiple Assign an issue to several people, roles or teams · Op task assign multiple #

Ask an LLM

“Can one issue have multiple assignees at the same time?”

“How do I assign an issue to a list of users plus a team?”

Tell an agent

Assign issue {ID} to users {userIDs}.

Assign issue {ID} to roles {roleIDs} and teams {teamIDs}.

PUT /optask/bulkMove Move many issues to another project · Op task bulk move #

Ask an LLM

“How do I move a batch of issues into a different project?”

“Can I move several issues under a new parent task at once?”

Tell an agent

Move issues {issueIDs} to project {projectID}.

Bulk move issues {issueIDs} under parent {parentID}.

PUT /optask/bulkMoveWithOptions Bulk move issues with rename and options · Op task bulk move with options #

Ask an LLM

“Can I rename issues while moving them to another project?”

“Which move call lets me pass extra options for what gets carried over?”

Tell an agent

Move issues {IDs} to project {projectID} and rename them {newName}.

Bulk move issues {IDs} under parent {parentID} with options {options}.

PUT /optask/calculateDataExtension Recalculate an issue's calculated custom fields · Op task calculate data extension #

Ask an LLM

“How do I force the calculated custom fields on an issue to refresh?”

“Can I recompute custom form data on one issue?”

Tell an agent

Recalculate the custom data on issue {ID}.

Refresh calculated custom fields for issue {ID}.

PUT /optask/convertToProject Convert an issue into a project · Op task convert to project #

Ask an LLM

“How do I turn an issue into a full project?”

“Can I keep the issue's categories when converting it to a project?”

Tell an agent

Convert issue {ID} into a project.

Convert issue {ID} to project {project} with exchange rate {exchangeRate}.

PUT /optask/convertToTask Convert an issue into a task · Op task convert to task #

Ask an LLM

“Can an issue be converted into a task on the project plan?”

“How do I convert an issue to a task and copy its native fields?”

Tell an agent

Convert issue {ID} into a task.

Turn issue {ID} into task {task} using options {options}.

PUT /optask/copyIssue Copy an issue into a project · Op task copy issue #

Ask an LLM

“How do I duplicate an issue with a new name?”

“Can I copy an issue into another project under a specific parent?”

Tell an agent

Copy issue {opTaskID} and name the copy {name}.

Copy issue {opTaskID} into project {projectID} under parent {parentID}.

PUT /optask/getRequestPath Get the request path for a queue topic · Op task get request path #

Ask an LLM

“How do I find the request path a queue topic belongs to?”

“What is the breadcrumb path for a request queue topic?”

Tell an agent

Get the request path for queue topic {queueTopicID}.

Show the request path for queue definition {queueDef}.

PUT /optask/linkExternalObject Link an external object to an issue · Op task link external object #

Ask an LLM

“Can I attach a link to an external system record on an issue?”

“How do I connect an issue to an object in an integration by URL?”

Tell an agent

Link external object {linkedObjectID} to issue {objID} via {integrationType}.

Link issue {objID} to the external item at {URL}.

PUT /optask/markDone Mark an issue as done · Op task mark done #

Ask an LLM

“How do I close out an issue as complete?”

“Can I choose the final status when marking an issue done?”

Tell an agent

Mark issue {ID} as done.

Complete issue {ID} with status {status}.

PUT /optask/markNotDone Reopen an issue marked done · Op task mark not done #

Ask an LLM

“How do I undo marking an issue complete?”

“Can I reopen an issue for a particular assignment?”

Tell an agent

Mark issue {ID} as not done.

Reopen issue {ID} for assignment {assignmentID}.

PUT /optask/move Move one issue to another project · Op task move #

Ask an LLM

“How do I move a single issue to a different project?”

“Which call relocates one issue without converting it?”

Tell an agent

Move issue {ID} to project {projectID}.

Relocate issue {ID} into project {projectID}.

PUT /optask/moveToTask Move an issue under a task · Op task move to task #

Ask an LLM

“Can I move an issue so it sits under a specific task?”

“How do I re-parent one issue onto a task in another project?”

Tell an agent

Move issue {ID} under task {parentID}.

Put issue {ID} under task {parentID} in project {projectID}.

PUT /optask/recallApproval Recall an issue approval request · Op task recall approval #

Ask an LLM

“How do I withdraw an approval request I submitted on an issue?”

“Can I recall an issue from its approval process?”

Tell an agent

Recall the approval on issue {ID}.

Withdraw issue {ID} from approval.

PUT /optask/rejectApproval Reject an issue's pending approval · Op task reject approval #

Ask an LLM

“How do I reject an issue that is awaiting my approval?”

“Can I explain why when rejecting an issue approval?”

Tell an agent

Reject the approval on issue {ID}.

Reject issue {ID} with the reason {auditNote}.

PUT /optask/replyToAssignment Reply to an issue assignment · Op task reply to assignment #

Ask an LLM

“How do I respond to an issue assignment with a note?”

“Can I give a commit date when replying to an issue I was assigned?”

Tell an agent

Reply to the assignment on issue {ID} with {noteText}.

Reply on issue {ID} committing to finish by {commitDate}.

PUT /optask/unacceptWork Un-accept work on an issue · Op task unaccept work #

Ask an LLM

“How do I undo accepting work on an issue?”

“Can I hand an accepted issue back and change its status?”

Tell an agent

Un-accept the work on issue {ID}.

Un-accept issue {ID} and set status {status}.

PUT /optask/unassign Unassign a user from an issue · Op task unassign #

Ask an LLM

“How do I remove a person from an issue's assignees?”

“Can I take a user off an issue without deleting it?”

Tell an agent

Unassign user {userID} from issue {ID}.

Remove the assignee from issue {ID}.

PUT /optask/unlinkExternalObject Unlink an external object from an issue · Op task unlink external object #

Ask an LLM

“How do I remove a linked external record from an issue?”

“Can I detach an integration link from an issue?”

Tell an agent

Unlink external object {linkedObjectID} from issue {objID}.

Remove the {integrationType} link {linkedObjectID} from issue {objID}.

GET /optask/defaultShownTimesheetIssues List issues shown by default on a timesheet · Get op task default shown timesheet issues #

Ask an LLM

“Which issues show up by default on my timesheet?”

“What issues will a timesheet display for logging hours?”

Tell an agent

List the default issues shown on timesheet {timesheetID}.

Show the issues I can log time against on my timesheet.

Adobe Suite Optask API

Operations 41

Documentation

Specifications

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification