Version 1.1
Connector Overview: This page documents all 71 actions for the Workfrontconnector v1.1.
Billing Records (2)
POST Create Billing Record
/attask/api/{version}/BILL
Create a new billing record for a project, optionally specifying description, amount, and status.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
The unique identifier of the project to associate with the billing record. |
|
|
A text description of the billing record. |
|
|
The monetary amount for the billing record. |
|
|
The numeric status value for the billing record. |
|
|
The response format expected from the API (e.g. application/json). |
GET Get Billing Records
/attask/api/{version}/bill/search
Retrieve a list of billing records, optionally filtered by project and with specific fields returned.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
A comma-separated list of fields to include in the response. |
|
|
The unique identifier of the project to filter billing records by. |
|
|
The response format expected from the API (e.g. application/json). |
Calendar Entry (3)
GET Search Calendar
/attask/{version}/CALEVT/search
Search for calendar entries based on criteria like date range, section, and external reference.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
A comma-separated list of fields to include in the response. |
|
|
The maximum number of calendar entries to return. |
|
|
The unique identifier of the calendar section to filter entries by. |
|
|
The start date to filter calendar entries from. |
|
|
The modifier for the start date filter, such as 'gte' or 'lte'. |
|
|
The modifier for the external reference ID filter. |
|
|
The response format expected from the API (e.g. application/json). |
GET Testing
/fields=*&$$LIMIT=2000&calendarSectionID=600730e30269d86955b0d76b25d3ecf5&startDate=$$TODAY+14d&color=pink
Retrieve a test set of calendar entries with predefined filters, including all fields and a limit of 2000.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
The response format expected from the API (e.g. application/json). |
PUT Update Event
/attask/{version}/CALEVT/{calevtId}
Update an existing calendar event by setting its external reference ID.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
API version, e.g., v15.0 |
|
|
The new external reference ID for the calendar event. |
|
|
The response format expected from the API (e.g. application/json). |
General (3)
POST Create a Note
/attask/api/{version}/note
Adds a new note/comment to a given Workfront object.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
The response format expected from the API (e.g. application/json). |
Options (3)
|
Option Name |
Description |
|---|---|
|
|
The text content of the note. |
|
|
The unique identifier of the object to attach the note to. |
|
|
The object code of the object to attach the note to. |
GET Search Notes
/attask/api/{version}/note/search
Retrieves notes where entryDate is greater than the specified date.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
The date and time to filter notes after (format: yyyy-MM-dd'T'HH:mm:ss:SSS-0000). |
|
|
The modifier for the entryDate filter (gt = greater than). |
|
|
Comma-separated list of fields to return (e.g., ID,noteText,entryDate,objID,objCode,owner:emailAddr). |
|
|
The response format expected from the API (e.g. application/json). |
GET Search objects
/attask/api/{version}/{objectCode}/search
Retrieves the object specified by the ID query parameter, including all fields and parameterValues.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
The object code (e.g., TASK, PROJ, USER) |
|
|
The unique identifier of the object to retrieve. |
|
|
Comma-separated list of fields to retrieve. Use '*' for all fields. |
|
|
The response format expected from the API (e.g. application/json). |
Custom Forms (7)
GET Category Parameters
/attask/api/{version}/CTGY/search
Search for category parameters (custom form categories) by ID and return specified fields.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
The unique identifier of the category to retrieve. |
|
|
A comma-separated list of fields to include in the response. |
|
|
The response format expected from the API (e.g. application/json). |
GET Custom Form Count
/attask/api/{version}/ctgy/count
Get the total count of custom forms (categories) in the system.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
The response format expected from the API (e.g. application/json). |
GET Get Custom Forms
/attask/api/{version}/ctgy/search
Search for custom forms by name with an optional modifier and return specified fields.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
A comma-separated list of fields to include in the response. |
|
|
The name of the custom form to search for. |
|
|
The modifier for the name filter, such as 'eq' or 'contains'. |
|
|
The response format expected from the API (e.g. application/json). |
GET Parameter Count
/attask/api/{version}/param/count
Get the total count of parameters (custom form fields) in the system.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
The response format expected from the API (e.g. application/json). |
GET Search Parameter Options
/attask/api/{version}/POPT/search
Search for parameter options (dropdown choices) and return specified fields.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
A comma-separated list of fields to include in the response. |
|
|
The response format expected from the API (e.g. application/json). |
PUT Update Parameter Option
/attask/api/{version}/POPT/{id}
Update the display order of a parameter option.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
id |
|
|
The new display order number for the parameter option. |
|
|
The response format expected from the API (e.g. application/json). |
PUT Update a Form's Group
/attask/api/{version}/ctgy/{id}
Update the group associated with a custom form by setting its group ID.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
id |
|
|
The unique identifier of the group to assign to the custom form. |
|
|
The response format expected from the API (e.g. application/json). |
Customer Data (2)
GET Get Customer Details
/attask/api/{version}/cust/{custId}
Retrieve detailed information about a specific customer by its ID.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
customer Id |
|
|
The response format expected from the API (e.g. application/json). |
GET Get Metadata
/attask/api/{version}/metadata
Retrieve metadata about the Workfront instance, such as available object types and fields.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
The response format expected from the API (e.g. application/json). |
Documents (6)
GET Download Document
/internal/document/download
Still a work in progress.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
The unique identifier of the document to download. |
|
|
The response format expected from the API (e.g. application/json). |
GET Search for Document
/attask/api/{version}/docu/search
Search for documents by ID or project, and return specified fields.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
The unique identifier of the document to find. |
|
|
The unique identifier of the project to filter documents by. |
|
|
A comma-separated list of fields to include in the response. |
|
|
The response format expected from the API (e.g. application/json). |
GET Search for Document Folders
/attask/api/{version}/DOCFDR/search
Search for document folders in the system.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
Filter by parent project ID. |
|
|
Filter by folder name (exact match behavior depends on server configuration). |
|
|
Comma-separated list of fields to include in the response. |
|
|
The response format expected from the API (e.g. application/json). |
GET Search for Document Versions
/attask/api/{version}/docv/search
Search for versions of a specific document and return specified fields.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
The unique identifier of the document to retrieve versions for. |
|
|
A comma-separated list of fields to include in the response. |
|
|
The response format expected from the API (e.g. application/json). |
POST Upload Document | Step One
/attask/api/{version}/upload
Initiate a document upload by providing the file to upload.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
The response format expected from the API (e.g. application/json). |
Options (1)
|
Option Name |
Description |
|---|---|
|
|
The file content or reference to upload. |
POST Upload Document | Step Two
/attask/api/{version}/document
Upload a document to Workfront by providing the document's name, handle, and object code.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
The response format expected from the API (e.g. application/json). |
Options (4)
|
Option Name |
Description |
|---|---|
|
|
The name of the document being uploaded. |
|
|
The handle or identifier for the document data. |
|
|
The object code for the document (e.g., "DOC" for documents). |
|
|
The unique identifier of the object to attach the note to. |
Download
GET Download Asset
x-oneteg-downloader-path-with-authorization
Download an asset from a given URL with configurable timeout and retry settings.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The HTTP method to use for the download request. |
|
|
The URL from which to download the asset. |
|
|
The name to assign to the downloaded asset. |
|
|
The number of download attempts to make before failing. |
|
|
The maximum time in seconds to wait for data to be read. |
|
|
The maximum time in seconds to wait for a connection to be established. |
|
|
This toggle enables you to load file content as the step output. Supported formats include JSON, XML, YML/YAML, CSV, TXT, and other text-based file types. Note that images, PDF files, and other binary formats cannot be loaded. Additionally, there is a file size limit for this feature; please check the logs for details. |
|
|
Enable or disable following URL redirects. If it is enabled, it will follow the URL redirects. |
|
|
Additional HTTP header name/value pairs to include in the request. |
Filters, Views, and Groupings (3)
GET Get Filters
/attask/api/{version}/UIFT/search
Retrieve a list of all filters available in Workfront.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
A comma-separated list of fields to include in the response. |
|
|
The response format expected from the API (e.g. application/json). |
GET Get Groupings
/attask/api/{version}/UIGB/search
Retrieve a list of all groupings available in Workfront.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
A comma-separated list of fields to include in the response. |
|
|
The response format expected from the API (e.g. application/json). |
GET Get Views
/attask/api/{version}/UIVW/search
Retrieve a list of all views available in Workfront.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
The unique identifier of the document to find. |
|
|
A comma-separated list of fields to include in the response. |
|
|
The response format expected from the API (e.g. application/json). |
Hours
GET Get Hours
/attask/api/{version}/HOUR/search
Retrieve a list of hour entries logged in Workfront.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
A comma-separated list of fields to include in the response. |
|
|
The response format expected from the API (e.g. application/json). |
Issues (3)
PUT Convert Issue to Project
/attask/api/{version}/issue/{issueId}/convertToProject
Be sure to update the request body to set the conversion options and project values.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
id |
|
|
A JSON string containing field updates for the new project. |
|
|
The response format expected from the API (e.g. application/json). |
Options (1)
|
Option Name |
Description |
|---|---|
|
|
An array of conversion options, such as "keepOriginal" or "includeAllTasks". |
GET Issue Search
/attask/api/{version}/optask/search
Search for issues (tasks in the issue queue) using query parameters.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
The unique identifier of the document to find. |
|
|
A comma-separated list of fields to include in the response. |
|
|
The response format expected from the API (e.g. application/json). |
POST Update Issue Assignment
/attask/api/{version}/ASSGN
Update the assignment of an issue by specifying the issue ID and the new assignee.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
The ID of the issue (opTask) whose assignment is being updated. |
|
|
The ID of the user to assign the issue to. |
|
|
The response format expected from the API (e.g. application/json). |
Layout Templates
GET Search Layout Templates
/attask/api/{version}/UITMPL/search
Search for layout templates using a search term.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
The name of the custom form to search for. |
|
|
The search term to filter layout templates by name. |
|
|
The modifier for the name filter, such as 'eq' or 'contains'. |
|
|
The response format expected from the API (e.g. application/json). |
Misc (2)
GET Search for User
/attask/api/{version}/USER/search
Search for users in Workfront using query parameters.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
The unique identifier of the document to find. |
|
|
A comma-separated list of fields to include in the response. |
|
|
The response format expected from the API (e.g. application/json). |
PUT Update metadata field
/attask/api/{version}/{objectCode}
Update metadata fields on any object type by specifying the object code and the updates.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
A JSON string containing the fields and values to update. |
|
|
The object code representing the type of object to update (e.g., "PROJ" for project). |
|
|
The response format expected from the API (e.g. application/json). |
New User Setup
POST Create Custom Form With ID View
/attask/api/{version}/UIVW
Create a new custom form with an ID view by providing view details and options.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
A JSON string defining the view's properties and fields. |
|
|
The response format expected from the API (e.g. application/json). |
Options (1)
|
Option Name |
Description |
|---|---|
|
|
Additional options for creating the view, such as setting it as a default. |
Portfolio
PUT Share Portfolio
/attask/api/{version}/port/{portId}/share
Share a portfolio with a user or group by specifying their ID and object code.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
portId |
|
|
The ID of the user, group, or team to share the portfolio with. |
|
|
The object code of the accessor (e.g., "USER" for user, "GROUP" for group). |
|
|
The response format expected from the API (e.g. application/json). |
Projects (11)
PUT Attach Template
/attask/{api}/{version}/project/{projectId}
Attach a template to an existing project, optionally specifying an action.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
api |
|
|
API version, e.g., v15.0 |
|
|
Project Id |
|
|
The action to perform when attaching the template, such as "attach" or "replace". |
|
|
The ID of the template to attach to the project. |
|
|
The response format expected from the API (e.g. application/json). |
POST Create Baseline
/attask/api/{version}/BLIN
Create a new baseline for a project, capturing a snapshot of the project's current state at a specific point in time. Use this to save project progress for future comparison or rollback.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
A JSON string defining the view's properties and fields. |
|
|
The response format expected from the API (e.g. application/json). |
Options (5)
|
Option Name |
Description |
|---|---|
|
|
The object code of the baseline object, typically 'BLIN'. |
|
|
An optional ID to assign to the new baseline; if omitted, Workfront generates one. |
|
|
The ID of the project for which to create the baseline. |
|
|
The name of the document being uploaded. |
|
|
Set to true to make this baseline the default for the project. |
POST Create Project From Template
/attask/api/{version}/project
Create a new project from a predefined template, optionally setting the initial project status. Use this to quickly spin up projects using a standardized structure.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
The name of the custom form to search for. |
|
|
The ID of the template to attach to the project. |
|
|
The initial status of the new project, such as 'CUR' for Current or 'PLN' for Planning. |
|
|
The response format expected from the API (e.g. application/json). |
GET Get Assignment Hours
/attask/api/{version}/ASSGN/search
Retrieve assignment hours by searching the ASSGN object. Use this to get the hours logged against assignments that match specified criteria.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
The unique identifier of the project to filter documents by. |
|
|
A comma-separated list of fields to include in the response. |
|
|
The response format expected from the API (e.g. application/json). |
GET Get Assignment Hours Report
/attask/api/{version}/ASSGN/report
Generate a report of assignment hours with aggregate functions applied. Use this to obtain summarized hours data, such as totals or averages, across assignments.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
The unique identifier of the project to filter documents by. |
|
|
A comma-separated list of fields to include in the response. |
|
|
The aggregate function to apply to the work hours field, for example 'SUM' or 'AVG'. |
|
|
The response format expected from the API (e.g. application/json). |
GET Get Baseline Tasks
/attask/api/{version}/BSTSK/search
Search for baseline tasks (BSTSK) associated with a specific baseline. Use this to retrieve the tasks captured in a particular baseline snapshot.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
The ID of the baseline whose tasks you want to retrieve. |
|
|
The response format expected from the API (e.g. application/json). |
GET Get Project Metadata
/attask/api/{version}/project/metadata
Get metadata for a project, including custom forms, fields, and other configuration details. Use this to inspect the structure and settings of a project without loading its full data.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
The response format expected from the API (e.g. application/json). |
GET Project Search
/attask/api/{version}/proj/search
Search for projects using various criteria, including status. Use this to find projects that match specific conditions such as being in a particular state.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
The unique identifier of the document to find. |
|
|
A comma-separated list of fields to include in the response. |
|
|
Filter projects by their status code, for example 'CUR' for Current or 'CPL' for Complete. |
|
|
The response format expected from the API (e.g. application/json). |
PUT Recalculate Timeline
/attask/api/{version}/{objCode}/{projectID}
Recalculate the timeline of a project, updating dates, durations, and dependencies. Use this after making changes that affect the project schedule to ensure accuracy.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
Project object code PROJ |
|
|
id |
|
|
The action to perform when attaching the template, such as "attach" or "replace". |
|
|
The response format expected from the API (e.g. application/json). |
GET Search Baselines
/attask/api/{version}/BLIN/search
Search for baselines across all projects. Use this to find existing baseline snapshots based on criteria such as project ID or baseline name.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
The unique identifier of the project to filter documents by. |
|
|
A comma-separated list of fields to include in the response. |
|
|
The response format expected from the API (e.g. application/json). |
PUT Update Project
/attask/api/{version}/project/{projectId}
Update an existing project's fields, such as its URL or other attributes. Use this to modify project information after creation.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
The ID of the project to update. |
|
|
The new URL value to set on the project. |
|
|
The response format expected from the API (e.g. application/json). |
Options (1)
|
Option Name |
Description |
|---|---|
|
|
Unique identifier for the asset or record |
Queues
GET Queue Topics
/attask/api/{version}/QUET/search
Retrieve queue topics for a specific queue definition (project). Use this to list the topics available in a request queue.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
The name of the custom form to search for. |
|
|
The ID of the project that contains the queue definition whose topics you want to fetch. |
|
|
The response format expected from the API (e.g. application/json). |
Reports and Dashboards
GET Search Reports
/attask/api/{version}PTLSEC/search
Search for reports based on the user who entered them. Use this to find reports created or modified by a specific person.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
A comma-separated list of fields to include in the response. |
|
|
The name of the user who entered the report. |
|
|
The modifier for the entered-by name filter, such as 'equal' or 'contains'. |
|
|
The response format expected from the API (e.g. application/json). |
Setup (2)
GET Search for Access Levels
/attask/api/{version}/acslvl/search
Search for access levels in the system. Use this to retrieve access level definitions and their settings.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
The name of the custom form to search for. |
|
|
A comma-separated list of fields to include in the response. |
|
|
The response format expected from the API (e.g. application/json). |
GET Search for Group
/attask/api/{version}/GROUP/search
Search for groups in Workfront. Use this to find groups by name or other criteria.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
A comma-separated list of fields to include in the response. |
|
|
The response format expected from the API (e.g. application/json). |
Tasks (7)
PUT Assign Form to Task
/attask/api/{version}/category/assignCategory
Assign a custom form to a task, linking the form to the object. Use this to attach additional data fields to a task.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
The ID of the task to which the form will be assigned. |
|
|
The object code of the task, typically 'TASK'. |
|
|
The ID of the custom form (category) to assign. |
|
|
The session ID for authentication, required to perform the assignment. |
|
|
The response format expected from the API (e.g. application/json). |
POST Create Task
/attask/api/{version}/task
Create a new task in Workfront. Use this to add a task with optional parent and predecessor expression.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
The unique identifier of the project to filter documents by. |
|
|
The response format expected from the API (e.g. application/json). |
Options (3)
|
Option Name |
Description |
|---|---|
|
|
The name of the document being uploaded. |
|
|
The ID of the parent task or project under which the new task is created. |
|
|
A string expression defining predecessor dependencies for the task. |
DELETE Delete Task
/attask/api/{version}/task/{taskId}
Permanently delete a specific task by its ID. Use this to remove a task from Workfront.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
Task Id |
|
|
The response format expected from the API (e.g. application/json). |
GET Get A Task
/attask/api/{version}/TASK/{taskId}
Retrieve details of a single task by its ID. Use this to get task fields and metadata.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
A comma-separated list of fields to include in the response. |
|
|
The unique identifier of the task to retrieve. |
|
|
The response format expected from the API (e.g. application/json). |
POST Get task form values
/internal/customform/data
Retrieve custom form data values for tasks. Use this to get the values of custom fields associated with tasks.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
The media type expected in the response, such as application/json. |
|
|
The session ID for authentication, required to perform the assignment. |
|
|
The response format expected from the API (e.g. application/json). |
Options (4)
|
Option Name |
Description |
|---|---|
|
|
The unique identifier of the object to attach the note to. |
|
|
The object code of the baseline object, typically 'BLIN'. |
|
|
An array of category IDs whose custom form data to retrieve. |
|
|
Whether to include default values for custom fields. |
GET Task Search
/attask/api/{version}/TASK/search
Search for tasks based on custom field values. Use this to find tasks matching a specific page ID.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
A comma-separated list of fields to include in the response. |
|
|
The custom field value for pageID to search for. |
|
|
The unique identifier of the project to filter documents by. |
|
|
The response format expected from the API (e.g. application/json). |
PUT Update A Task
/attask/api/{version}/TASK/{taskId}
Update an existing task's fields. Use this to modify task properties like status, name, or custom data.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
The version number of the task object for optimistic locking. |
|
|
The unique identifier of the task to update. |
|
|
The response format expected from the API (e.g. application/json). |
Teams
GET Search for Teams
/attask/api/{version}/TEAMOB/count
Retrieve the count of team objects that match search criteria. Use this to get the number of teams without fetching full details.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
The name of the custom form to search for. |
|
|
The modifier for the name filter, such as 'eq' or 'contains'. |
|
|
The response format expected from the API (e.g. application/json). |
Templates
GET Search for template
/attask/api/{version}/TMPL/search
Search for project templates based on query parameters. Use this to find templates matching specific criteria.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
The unique identifier of the document to find. |
|
|
The response format expected from the API (e.g. application/json). |
Users (8)
GET Count of Active Users
/attask/api/{version}/USER/count
Get the count of users filtered by active status. Use this to determine how many active or inactive users exist.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
Boolean indicating whether to count only active users (true) or inactive users (false). |
|
|
The response format expected from the API (e.g. application/json). |
POST Create User
/attask/api/{version}/user
Create a new user in Workfront with optional profile and access settings. Use this to provision a user account.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
A JSON string defining the view's properties and fields. |
|
|
The response format expected from the API (e.g. application/json). |
Options (12)
|
Option Name |
Description |
|---|---|
|
|
The email address for the new user. |
|
|
The user's first name. |
|
|
The user's last name. |
|
|
The ID of the home group for the user. |
|
|
Whether the user account is active. |
|
|
The initial password for the user. |
|
|
Whether the user can only access via SSO. |
|
|
The unique username for the user. |
|
|
The ID of the access level to assign. |
|
|
The ID of the company the user belongs to. |
|
|
An external reference ID for the user. |
|
|
The ID of the user's manager. |
DELETE Delete User
/attask/api/{version}/user
Delete a user from Workfront. Use this to remove a user account, optionally forcing deletion even if the user has records.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
The unique identifier of the document to find. |
|
|
Boolean indicating whether to force deletion despite existing data references. |
|
|
The response format expected from the API (e.g. application/json). |
GET Environment Check
/attask/api/{version}/cust/search
Search for custom environment configurations. Use this to verify environment settings or retrieve custom data.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
The response format expected from the API (e.g. application/json). |
PUT Generate API Key
/attask/api/{version}/user
Generate a new API key for a user by providing credentials. Use this to obtain an API key for programmatic access.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
The action to perform when attaching the template, such as "attach" or "replace". |
|
|
The username of the user to generate the API key for. |
|
|
The password of the user. |
|
|
The response format expected from the API (e.g. application/json). |
POST Login
/attask/api/{version}/login
Authenticate a user and obtain a session token. Use this to log in and receive credentials for subsequent API calls.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
The username to log in with. |
|
|
The password for the user. |
|
|
The response format expected from the API (e.g. application/json). |
GET Sharing Permissions
/attask/api/{version}/PROJ/count
Count the number of projects that match the specified filters, such as portfolio ID or status.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
Filter projects by a specific portfolio ID using a modifier. |
|
|
Filter projects by their status code, for example 'CUR' for Current or 'CPL' for Complete. |
|
|
Filter projects by a specific status using a modifier. |
|
|
A comma-separated list of fields to include in the response. |
|
|
The maximum number of calendar entries to return. |
|
|
Specify the starting index for pagination to return a subset of results. |
|
|
The response format expected from the API (e.g. application/json). |
PUT Update user
/attask/api/{version}/user/{userId}
Update an existing user's information, such as their access level.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
API version, e.g., v15.0 |
|
|
API version, e.g., v15.0 |
|
|
The ID of the new access level to assign to the user. |
|
|
The response format expected from the API (e.g. application/json). |
Webhooks (3)
POST Create Webhook
/attask/eventsubscription/api/v1/subscriptions
Create a new webhook subscription to receive event notifications from Workfront.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
The content type of the request payload sent to the API (e.g. application/json). |
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
The response format expected from the API (e.g. application/json). |
Options (4)
|
Option Name |
Description |
|---|---|
|
|
The object code of the baseline object, typically 'BLIN'. |
|
|
The type of event that triggers the webhook notification. |
|
|
The URL where the webhook payload will be sent. |
|
|
An optional authentication token to include in the webhook request. |
DELETE Delete Webhook
/attask/eventsubscription/api/v1/subscriptions/{id}
Delete an existing webhook subscription by its unique identifier.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
The unique identifier of the webhook subscription to delete. |
|
|
The content type of the request, typically application/json. |
|
|
The response format expected from the API (e.g. application/json). |
GET Querying Webhooks
/attask/eventsubscription/api/v1/subscriptions/list
Retrieve a list of all existing webhook subscriptions.
Parameters
|
Parameter Name |
Description |
|---|---|
|
|
Additional HTTP header name/value pairs to include in the request. |
|
|
Additional query string name/value pairs to append to the request URL. |
|
|
The content type of the request, typically application/json. |
|
|
The response format expected from the API (e.g. application/json). |