What’s new in API version 17

Adobe Workfront released API version 17 on October 12, 2023. API version 17 features the following changes from version 16.

Added resources

ExternalDocument (EXTDOC)

An ExternalDocument object is a document or other digital asset that is located in a document storage provider external to Workfront. These assets can be linked to and from Workfront.

Direct fields
  • dateModified

  • description

  • documentProviderID

  • ext

  • fileType

  • iconURL

  • ID

  • name

  • path

  • providerType

  • readOnly

  • size

  • thumbnailURL

Core fields
  • dateModified

  • description

  • documentProviderID

  • ext

  • fileType

  • iconURL

  • ID

  • isGoogleRootItem

  • isTeamDriveItem

  • name

  • objCode

  • path

  • providerType

  • readOnly

  • size

  • thumbnailURL

  • value

Default fields
  • ID

  • name

  • objCode

Actions
  • browseListWithLinkAction

  • getDocumentDownloadUrl

  • getRootFolderID

  • getRootFolderIDFromDB

  • linkExternalDocumentObjects

  • setLinkedFolderMetadata

Queries
  • browseList

  • getFolderMetaData

  • searchExternalDocuments

Operations
  • SEARCH

UserLocation (USRLOC)

Direct fields
  • classifierID

  • customerID

  • endDate

  • ID

  • isCurrent

  • startDate

  • userID

Reference fields
  • customer

  • user

Core fields
  • ID

  • objCode

Removed resources

No resources were removed for API version 17

Modified resources

The following resources were modified for API version 17.

Baseline (BLIN)

Baselines are snapshots of what the performance of a project looked like at a given moment in time. They store key pieces of information about the project, like key dates, progress, cost and revenue values.

The Baseline object removed the flag INLINE_EDITABLE.

BillingRecord (BILL)

A BillingRecord object records the revenue, hours, or expenses that can be billed. This information can be used to create invoices in an external accounting system.

The BillingRecord object removed the flag INLINE_EDITABLE.

Company (CMPY)

A Company object represents an organization consisting of a collection of people.

Direct fields
  • defaultInterface

    Removed

CustomerPreferences (CUSTPR)

A CustomerPreferences object represents the set of preferences that a customer has set for their instance of Workfront.

Direct fields
  • name

    Added the possible value "config.defaultToNewHomeDescription" (customer:config.defaultToNewHome)>/p?

    This allows an organization to make the new Home experience the default for its users.

DocumentVersion (DOCV)

A DocumentVersion object represents a specific version of a file (such as written material, images, or other forms of information).

Direct fields
  • externalIntegrationType

    Added the possible value "Frame.io" (FRAMEIO)

  • fileType

    Added the possible value "enum.filetype.site" (site)

ExchangeRate (EXRATE)

An ExchangeRate object represents a currency exchange rate set up in Workfront. ExchangeRate objects are not dynamic.

Direct fields

The following fields were added:

  • endDate

  • startDate

Actions
  • getCustomerCurrencies

    Added.

Expense (EXPNS)

Expenses represent the non-labor costs that might be incurred during the life of a project.

The Expense object removed the flag INLINE_EDITABLE.

Group (GROUP)

A Group object represents a set of users and teams. Groups often represent departmental structure.

Direct fields
  • defaultInterface

    Removed

Hour (HOUR)

An Hour object represents an hour logged by a user on a timesheet.

The Hour object removed the flag INLINE_EDITABLE.

Iteration (ITRN)

An Iteration object represents a single Agile Iteration. Iterations are discrete periods of time used to plan and complete Agile stories.

The Iteration object removed the flag INLINE_EDITABLE.

JournalEntry (JRNLE)

The JournalEntry object can be set up to log information about specific object fields any time those fields are modified. When a field is set up to be logged as a part of the Journal Entry object, a corresponding Journal Entry will be created every time that field is modified.

Direct fields
  • changeType

    Added the following possible values:

    • Added approver (AAA)
    • Added reviewer (AAR)
    • Removed reviewer (ARR)
    • Removed approver (ARA)
    • Decision approved (ADA)
    • Decision approved with changes (ADC)
    • Decision needs work (ADN)
    • Decision revoked (ADR)
    • Approver changed (AAC)
    • Reviewer changed (ARC)
    • Review complete (RDC)
    • Review revoked (RDR)
    • Publish (PUB)

Kanban Board (KNBNBD)

A Kanban board is used to track tasks in an Agile environment.

The Kanban Board object removed the flag INLINE_EDITABLE.

LinkedFolder (LNKFDR)

A LinkedFolder object represents a folder linked from an external document provider, such as Google Drive or Dropbox.

Direct fields
  • externalIntegrationType

    Added possible value "Frame.io (FRAMEIO)

OpTask / Issue (OPTASK)

An OpTask object is commonly known as an Issue. An issue is a work item that usually indicates that there is a problem preventing the completion of a task or project. An Issue can also be a Help Desk request. Change Orders, Requests, and Bugs are also Issues.

The Issue object removed the flag INLINE_EDITABLE.

Project (PROJ)

Projects are work items within Workfront, and are a main building block in the way Workfront helps people to do work. A Project object represents a group of tasks with a common, specific goal.

The Project object removed the flag INLINE_EDITABLE.

ProjectUser (PRTU)

A ProjectUser object represents a user associated with a specific project.

Direct fields
  • ID

    Added.

Core fields
  • ID

    Added.

Rate (RATE)

A Rate object represents a billing rate in Workfront.

The Rate object removed the flag INLINE_EDITABLE.

Actions

The following actions have been added to support Rate Card functionality:

  • deleteRateForRole

  • editRatesForRole

  • getUsedClassifierIds

  • setRatesFromRateCard

The setRatesForRole action has been modified to add the following fields:

  • classifierID
  • currencyCode
  • sourceRateCardID

Risk (RISK)

A Risk object represents a possible event that may prevent a project from finishing on time or within budget. Risks are added to projects in the planning phase to identify potential obstacles prior to the approval of any work.

The Risk object removed the flag INLINE_EDITABLE.

Role / Job Role (ROLE)

A Role object (job role) represents a functional capacity or a skill set a user might fill, such as Designer or Product Manager.

Direct fields
  • defaultInterface

    Removed

Task (TASK)

A Task object represents a work item that must be performed as a step toward achieving a final goal (completing a Project).

The Task object removed the flag INLINE_EDITABLE.

Team (TEAMOB)

A Team object is a collection of Users that can be assigned to a work item.

Direct fields
  • defaultInterface

    Removed

TeamMember (TEAMMB)

A TeamMember object is a user associated with a specific team.

Direct fields
  • ID

    Added.

Core fields
  • ID

    Added.

TemplateUser (TMTU)

Direct fields
  • ID

    Added.

Core fields
  • ID

    Added.

Timesheet (TSHET)

A Timesheet object represents a virtual timecard that allows Users to enter actual hours worked for Tasks, Projects, and overhead Hour Types.

Direct fields
  • objCode

    Removed

Update (UPDATE)

Work Items in Workfront can be updated to keep users informed of the current status. An Update object represents one of these updates. Updates can be entered by users or created by the Workfront system.

Direct fields
  • changeType

    Added the following values:

    • Added approver (assetapprovalAddApprover)
    • Added reviewer (assetapprovalAddReviewer)
    • Removed approver (assetapprovalRemoveApprover)
    • Removed reviewer (assetapprovalRemoveReviewer)
    • Decision approved (assetapprovalDecisionApproved)
    • Decision needs work (assetapprovalDecisionNeedsWork)
    • Decision approved with changes (assetapprovalDecisionApprovedChanges)
    • Decision revoked (assetapprovalDecisionRevoked)
    • Approver changed (assetapprovalApproverChanged)
    • Reviewer changed (assetapprovalReviewerChanged)
    • Review complete (assetapprovalReviewerDecisionComplete)
    • Review revoked (assetapprovalReviewerDecisionRevoked)
    • External document send error (externalDocumentSendError)
    • Document version published (documentVersionPublish)
    • Linked folder workflow (linkedFolderWorkflow)

User (USER)

A User object represents a person with an account in Workfront that can log in and interact with the system.

The User object removed the flag INLINE_EDITABLE.

Direct fields
  • workTime

    This field has been added, and is a number between 0 and 1 that represents the percentage of time that a user can spend on project work (non-overhead work) each day. A value of 1 means the user can spend 100% of their time on project work.

Collection fields
  • userLocations

UserGroups (USRGPS)

Direct fields
  • ID

    Added.

Core fields
  • ID

    Added.

UserNote (USRNOT)

A UserNote object is a notification.

Direct fields
  • changeType

    Added the following values:

    • Document needs your approval (AAA)
    • Document needs your review (AAR)
    • Document no longer needs your approval (ARA)
    • Document no longer needs your review (ARR)
    • Document needs (user)'s approval (ATA)
    • Document needs (user)'s review (ATR)
    • Document no longer needs (user)'s approval (RTA)
    • Document no longer needs (user)'s review (RTR)
    • Document approved (ADA)
    • Document approved with changes (ADC)
    • Document needs work (ADN)
    • (User) has marked (document) as approved. Your approval is no longer needed. (AAN)
    • (User) has marked (document) as approved with changes. Your approval is no longer needed. (ACN)
    • (User) has marked (document) as needs work. Your approval is no longer needed. (AWN)
    • Document needs your review now rather than approval (AAC)
    • Document needs your approval now rather than a review (ADN)
    • Document reviewed (RDC)
    • Document reviewed (TRC)
    • (User) has reviewed (document) as complete. Your review is no longer needed. (TRN)

UserRole (USRROL)

Direct fields
  • ID

    Added.

Core fields
  • ID

    Added.

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43