Tracelink University
## Breadcrumb
1. [Home](/)
2. [Resources](/resources/resource-center)
3. [TraceLink University](/resources/tracelink-university)
# List APIs
- [Download PDF](/node/628316/pdf)
- [Share](#)
- [ LinkedIn ](https://www.linkedin.com/shareArticle?mini=true&url=https://www.tracelink.com/resources/tracelink-university/list-apis&title=List APIs&summary=Companies that own or link to Agile Process Teams use these APIs to add, edit, and delete lists. &source=TraceLink "LinkedIn")
- [ Facebook ](https://www.facebook.com/share.php?u=https://www.tracelink.com/resources/tracelink-university/list-apis&t=List APIs "Facebook")
- [ Mail ](mailto:?subject=List APIs+|+TraceLink&body=https://www.tracelink.com/resources/tracelink-university/list-apis "Mail")
- [ Twitter ](https://twitter.com/intent/tweet?text=List APIs https://www.tracelink.com/resources/tracelink-university/list-apis&via=TraceLink "Twitter")
#### Table of contents
Companies that own or link to Agile Process Teams use these APIs to add, edit, and delete lists. A List is a multi-enterprise business object that allows to group multiple Items, Work Items, and sub-types. Owners can collaborate internally or externally with Partners to meet to track and complete a series of tasks (items, work items, and subtypes) in a list required to achieve a business objective.
## Add list
Owners and Partners use this API to add a new list to the Owner's company network, including any initial comments or file attachments. The response returns a generated identifier for the new list.
New tasks are assigned the `Draft` base state by default.
 Contact your TraceLink Services representative for more information about using this API.
[Add list request](#)#### Guidelines
Element Type Description mutation ListNew { list {
new(
Method The mutation for creating the List. input Object **Required.** The input parameter. \[payload: payload\] Object **Required.** The actual values that need to be inserted. subType String The Subtype name . id String ID of the list. currentBaseState String For new records, the currentBaseState is DRAFT . currentSubState String For new records, the currentBaseState is DRAFT . data Object listTitle String **Required.** The title details of List. description String The description of the list. listEntities - - displayIdentifier String List of displayIdentifiers from workItem that must be linked with List. comments Array of Objects Contains comment text and attachment. commentText String Comment text. attachments String of JSON Data Attachment associated with the comment. objectAction - For ListNew, the actionName is CREATE. { businessObjectIdentifier } - The BusinessObjectTypeNameand businesssObjectIdentifier(GUID) fields contain information of what data is newly inserted. #### Example
```plaintext
mutation WorkItemNew {
workItem {
new(
input: {
workItem: {
payload: {
id: "6d211f5d-96bb-4bc2-8a27-006d517602da"
currentBaseState: "Draft"
data: {
workItemTitle: "Missing product details"
dueDate: 1747831980000
followers: [
{ followerId: "c55ff5ff-66d0-4c31-b2e4-5947a7e21955" }
]
comments: [
{
attachments: [
"{\"fileName\":\"test\",\"fileExtension\":\"rtf\",\"mimeType\":\"text/rtf\",\"fileSize\":391,\"s3FileReference\":\"attachments/workItem/37287894-d3fe-42b7-8c1d-0dc36e5f4216\",\"fileStatus\":\"UPLOADED\"}"
]
commentText: "Comment text from Peter while creation"
}
]
assigneeCompany: {
businessName: "QAPartnerCorp1202409240834280621"
primaryIdentifierValue: "2054051864409"
primaryIdentifierType: "GLN"
}
assigneeUser: {
userName: "Marvin"
userEmail: "qeauto+qapartnercorp1202409240834280621-coa@tracelink.com"
}
}
}
objectAction: "UPDATE"
}
}
) {
businessObjectTypeName
businessObjectIdentifier
businessObjectDataVersion
mutateMessage
isAsync
asyncRequestDetails {
requestIdentifier
requestStatus
consumerPollIntervalMS
__typename
}
created {
id
objectTypeName
dataVersion
__typename
}
updated {
id
objectTypeName
dataVersion
__typename
}
deleted {
id
objectTypeName
dataVersion
__typename
}
__typename
}
__typename
}
}
```
[Add list response](#)#### Guidelines
Element Type Description Response Method - data Object - list - - created - - id - GUID of newly inserted List. #### Example
```plaintext
{
"data": {
"workItem": {
"new": {
"businessObjectTypeName": "workItem",
"businessObjectIdentifier": "4fe82f69-605d-4608-a714-fdc279e6dce5",
}
}
}
}
```
#### Errors
This app uses [standard HTTP response codes](intro_to_apis.htm#http). If an error occurs, additional available information regarding the cause of the error is provided in the **errMsg** element in the relevant response.
## Edit list
Owners and Partners use this API to modify an existing list with new, updated, or corrected information (e.g. adding a description, updating the assignee company details, fixing a typo) and to update the workflow state (e.g. manually transitioning the base state from `Draft` to `ToDo` to indicate that the work assigned in the list has started).
 Contact your TraceLink Services representative for more information about using this API.
[Edit list request](#)#### Guidelines
Element Type Description mutation ListEdit { list {
edit(
Method The mutation for updating the List. input Object **Required.** The input parameter. \[payload: payload\] Object **Required.** The values that need to be inserted. subType String Subtype is non mandatory parameter when we are performing actions on Base Object. For Subtype it's mandatory to provide a Subtype name. id String **Required.** The List GUID to update the exact record. currentBaseState String Change the Workflow state from Draft to ToDo/InProgress/Done. currentSubState String Change the Workflow state from Draft to ToDo/InProgress/Done. data Object - listTitle String **Required.** Contains the title details of List. description String Change the description of the List. listEntities Array of Objects Contains the display identifier of the list. displayIdentifier String List of displayIdentifiers from workItem that must be linked with List. comments Array of Objects Contains comment text and attachment. commentText String Comment text. attachments String of JSON Data Attachment associated with the comment objectAction - For listEdit, the actionName is UPDATE. { businessObjectIdentifier } - The BusinessObjectTypeName and businesssObjectIdentifier(GUID) fields contain information of what data is updated. #### Example
```plaintext
mutation WorkItemEdit {
workItem {
edit(
input: {
workItem: {
payload: {
id: "6d211f5d-96bb-4bc2-8a27-006d517602da"
currentBaseState: "Draft"
data: {
workItemTitle: "Missing product details"
dueDate: 1747831980000
followers: [
{ followerId: "c55ff5ff-66d0-4c31-b2e4-5947a7e21955" }
]
comments: [
{
attachments: [
"{\"fileName\":\"test\",\"fileExtension\":\"rtf\",\"mimeType\":\"text/rtf\",\"fileSize\":391,\"s3FileReference\":\"attachments/workItem/37287894-d3fe-42b7-8c1d-0dc36e5f4216\",\"fileStatus\":\"UPLOADED\"}"
]
commentText: "Comment text from Peter while creation"
}
]
assigneeCompany: {
businessName: "QAPartnerCorp1202409240834280621"
primaryIdentifierValue: "2054051864409"
primaryIdentifierType: "GLN"
}
assigneeUser: {
userName: "Marvin"
userEmail: "qeauto+qapartnercorp1202409240834280621-coa@tracelink.com"
}
}
}
objectAction: "UPDATE"
}
}
) {
businessObjectTypeName
businessObjectIdentifier
}
}
```
[Edit list response](#)#### Guidelines
Element Type Description Response Method - data Object - list - - updated - - id - GUID of newly updated WorkItem. #### Example
```plaintext
{
"data": {
"workItem": {
"edit": {
"businessObjectTypeName": "workItem",
"businessObjectIdentifier": "4fe82f69-605d-4608-a714-fdc279e6dce5",
}
}
}
}
```
#### Errors
This app uses [standard HTTP response codes](intro_to_apis.htm#http). If an error occurs, additional available information regarding the cause of the error is provided in the **errMsg** element in the relevant response.
## Search list
Owners and Partners can use this API to search for a work item in the list. Provide a list of sort fields, page size, and paging info to search for a list.
 Contact your TraceLink Services representative for more information about using this API.
[Search list request](#)#### Guidelines
Element Type Description query ListSearch { list { search( Method The query for getting the details of the List input Object **Required.** The input parameter. queryString String Contains the searching index and its values. sortFields String Sorting index array. pageSize Integer Page size in numeric. pagingInfo String Page information. List of fields that you can pass on to Search method to fetch data The fields provided in the view GraphQl query will be returned in the response if data is present in the list. pagingInfo - - documents - - id String **Required.** Enter the WorkItem GUID to update the exact record. currentBaseState String Current Base State Value. currentSubState String Current Sub Base State Value if Sub workFlows are activated. lastUpdatedDateTime String Last updated date time. lastUpdatedDateTimeFormatted String Last updated users GUID. data Object - currentState String This field contains the value of currentSubState if present, otherwise currentBaseState. That means currentState is ultimate State of the List. displayIdentifier String List identifier in readable format with Prefix-Counter (integer). listTitle String Title of the list. description Integer Description of the list. lastModifiedTimestamp Integer lastModifiedTimeStamp of List. lastModifiedTimestampFormatted Date lastModifiedTimeStampFormatted of lastModifiedTimeStamp from List. #### Example
```plaintext
query WorkItemSearch {
workItem {
search(
input: {
queryString: "(indexLuceneSubType:\"\" OR indexLuceneSubType:null)"
sortFields: [{ field: "index-lastUpdatedDateTime", sortAsc: false }]
pageSize: 3
pagingInfo: ""
}
) {
pagingInfo
documents {
id
currentBaseState
currentSubState
subType
lastUpdatedDateTime
lastUpdatedDateTimeFormatted
data {
currentState
displayIdentifier
workItemTitle
dueDateFormatted
initiatingCompany {
businessName
}
assigneeCompany {
businessName
}
}
}
facets {
indexName
path
matchedDocsCount
childFacetsCount
childFacets {
facetedName
matchedDocsCount
}
}
}
}
}
```
[Search list response](#)#### Guidelines
Element Type Description Response Method - data Object - list - - search - - pagingInfo - Page information if the current page is not the first one. documents - The details queried for the work item (e.g. display identifier, item title, current state, comments, followers, etc.). #### Example
```plaintext
{
"data": {
"workItem": {
"search": {
"pagingInfo": "eyJwYWdlSW5kZXgiOjEsInBhZ2luZ0luZm9LZXkiOm51bGx9",
"documents": [
{
"id": "4fe82f69-605d-4608-a714-fdc279e6dce5",
"currentBaseState": "Draft",
"currentSubState": null,
"subType": "",
"lastUpdatedDateTime": 1747227964874,
"lastUpdatedDateTimeFormatted": "5/14/25, 1:06 PM (GMT)",
"data": {
"currentState": "Draft",
"displayIdentifier": "WI-331",
"workItemTitle": "ssss",
"dueDateFormatted": "May 30, 2025, 12:59:00 PM (GMT)",
"initiatingCompany": {
"businessName": "QAOwnerCorp202409240834253301",
"__typename": "InitiatingCompanyLocationTypeDefinition"
},
"assigneeCompany": null,
"__typename": "WorkItemData"
},
"__typename": "WorkItem"
},
{
"id": "6d211f5d-96bb-4bc2-8a27-006d517602da",
"currentBaseState": "Draft",
"currentSubState": null,
"subType": "",
"lastUpdatedDateTime": 1747227496355,
"lastUpdatedDateTimeFormatted": "5/14/25, 12:58 PM (GMT)",
"data": {
"currentState": "Draft",
"displayIdentifier": "WI-330",
"workItemTitle": "Missing product details",
"dueDateFormatted": "May 21, 2025, 12:53:00 PM (GMT)",
"initiatingCompany": {
"businessName": "QAOwnerCorp202409240834253301",
"__typename": "InitiatingCompanyLocationTypeDefinition"
},
"assigneeCompany": {
"businessName": "QAPartnerCorp1202409240834280621",
"__typename": "BusinessCompanyLocationTypeDefinition"
},
"__typename": "WorkItemData"
},
"__typename": "WorkItem"
},
{
"id": "4796f641-dba9-47b4-b8c6-b0acb41ed2c8",
"currentBaseState": "Draft",
"currentSubState": null,
"subType": "",
"lastUpdatedDateTime": 1747135410051,
"lastUpdatedDateTimeFormatted": "5/13/25, 11:23 AM (GMT)",
"data": {
"currentState": "Draft",
"displayIdentifier": "WI-329",
"workItemTitle": "rwer",
"dueDateFormatted": "May 20, 2025, 11:23:14 AM (GMT)",
"initiatingCompany": {
"businessName": "QAOwnerCorp202409240834253301",
"__typename": "InitiatingCompanyLocationTypeDefinition"
},
"assigneeCompany": null,
"__typename": "WorkItemData"
},
"__typename": "WorkItem"
}
],
"facets": [],
"__typename": "WorkItemSearchResult"
},
"__typename": "WorkItemQueryOps"
}
}
}
```
#### Errors
This app uses [standard HTTP response codes](intro_to_apis.htm#http). If an error occurs, additional available information regarding the cause of the error is provided in the **errMsg** element in the relevant response.
## Delete list
Owners use this API to delete a work item that is no longer required. Provide the work item identifier in the input field and the current base state to delete a work item.
 Contact your TraceLink Services representative for more information about using this API.
[Delete list request](#)#### Guidelines
Element Type Description mutation ListDelete { list {
delete(
Method The mutation for deleting the List. input Object **Required.** The input parameter. id String **Required.** The List GUID to update the exact record. { businessObjectIdentifier } - The BusinessObjectTypeName and businesssObjectIdentifier (GUID) fields contain information of what data is updated. #### Example
```plaintext
mutation WorkItemDelete {
workItem {
delete(input: { id: "4fe82f69-605d-4608-a714-fdc279e6dce5" }) {
businessObjectTypeName
businessObjectIdentifier
}
__typename
}
}
```
[Delete list response](#)#### Guidelines
Element Type Description Response Method - data Object - list - - deleted - - id - GUID of deleted list. displayIdentifier - Readable Identifier which is used with configured prefix value (Eg: POET-111). #### Example
```plaintext
{
"data": {
"workItem": {
"delete": {
"businessObjectTypeName": "workItem",
"businessObjectIdentifier": "4fe82f69-605d-4608-a714-fdc279e6dce5",
}
}
}
}
```
#### Errors
This app uses [standard HTTP response codes](intro_to_apis.htm#http). If an error occurs, additional available information regarding the cause of the error is provided in the **errMsg** element in the relevant response.
## Follow list
Owners and Partners use this API to start following a work item. Provide the item identifier to start following the work item.
 Contact your TraceLink Services representative for more information about using this API.
[Follow list request](#)#### Guidelines
Element Type Description mutation ListStartFollow { list {
startFollow(
Method The mutation for updating List followers list. input object **Required.** The input parameter. id String **Required.** The List GUID to update the exact record. { businessObjectIdentifier } - The BusinessObjectTypeName and businesssObjectIdentifier(GUID) fields contain information of what data is updated. #### Example
```plaintext
mutation WorkItemStartFollow {
workItem {
startFollow(input: {id: "2335af1c-4193-469d-b9c2-61400032f74e"}) {
businessObjectTypeName
businessObjectIdentifier
businessObjectDataVersion
mutateMessage
isAsync
updated {
id
objectTypeName
dataVersion
__typename
}
__typename
}
__typename
}
}
```
[Follow list response](#)#### Guidelines
Element Type Description Response Method - data Object - list - - updated - - id - GUID of newly updated List. displayIdentifier - Readable Identifier which is used with configured prefix value (Eg: POET-111). #### Example
```plaintext
{
"data": {
"workItem": {
"startFollow": {
"businessObjectTypeName": "workItem",
"businessObjectIdentifier": "d972e6ec-5ec7-4d81-ac13-41aa40e60e64",
"businessObjectDataVersion": 4,
"mutateMessage": "Successfully followed the Work Item",
"isAsync": null,
"updated": [
{
"id": "d972e6ec-5ec7-4d81-ac13-41aa40e60e64",
"objectTypeName": "workItem",
"dataVersion": 4,
"__typename": "MutateOperationResultEntryTypeDef"
}
],
"__typename": "MutateOperationResultTypeDef"
},
"__typename": "WorkItemMutationOps"
}
}
}
```
#### Errors
This app uses [standard HTTP response codes](intro_to_apis.htm#http). If an error occurs, additional available information regarding the cause of the error is provided in the **errMsg** element in the relevant response.
## Unfollow list
Owners and Partners use this API to stop following a work item. Provide the work item identifier to stop following a work item.
 Contact your TraceLink Services representative for more information about using this API.
[Unfollow list request](#)#### Guidelines
Element Type Description mutation ListStopFollow { list { stopFollow( Method The mutation for updating the List followers list. input Object **Required.** The input parameter. id String **Required.** The WorkItem GUID to update the exact record. { businessObjectIdentifier } - The BusinessObjectTypeName and businesssObjectIdentifier(GUID) fields contain information of what data is updated. #### Example
```plaintext
mutation WorkItemStopFollow {
workItem {
stopFollow(input: {id: "2335af1c-4193-469d-b9c2-61400032f74e"}) {
businessObjectTypeName
businessObjectIdentifier
businessObjectDataVersion
mutateMessage
isAsync
updated {
id
objectTypeName
dataVersion
__typename
}
__typename
}
__typename
}
}
```
[Unfollow list response](#)#### Guidelines
Element Type Description Response Method - data Object - list - - new - - id - GUID of newly updated List displayIdentifier - Readable Identifier which is used with configured prefix value (Eg: POET-111) #### Example
```plaintext
{
"data": {
"workItem": {
"stopFollow": {
"businessObjectTypeName": "workItem",
"businessObjectIdentifier": "d972e6ec-5ec7-4d81-ac13-41aa40e60e64",
"businessObjectDataVersion": 3,
"mutateMessage": "Successfully unfollowed the Work Item",
"isAsync": null,
"updated": [
{
"id": "d972e6ec-5ec7-4d81-ac13-41aa40e60e64",
"objectTypeName": "workItem",
"dataVersion": 3,
"__typename": "MutateOperationResultEntryTypeDef"
}
],
"__typename": "MutateOperationResultTypeDef"
},
"__typename": "WorkItemMutationOps"
}
}
}
```
#### Errors
This app uses [standard HTTP response codes](intro_to_apis.htm#http). If an error occurs, additional available information regarding the cause of the error is provided in the **errMsg** element in the relevant response.
## View list
Owners and Partners use this API to view an item. Provide the item identifier to view an item.
 Contact your TraceLink Services representative for more information about using this API.
[View list request](#)#### Guidelines
Element Type Description query ListView { list { view( Method The query for getting details of the List. input Object **Required.** The input parameter. id String **Required.**The List GUID to update the exact record. List of fields that you can pass on to View method to fetch data - The fields provided in the view GraphQl query will be returned in the response if data is present in the list. id String GUID of List. currentBaseState String Current Base State Value. currentSubState String Current Sub Base State Value if Sub workflows are activated. lastUpdatedDateTime Integer Last updated date time. lastUpdatedDateTimeFormatted String Last updated users GUID. data Object - currentState String This field will hold value of currentSubState if present, otherwise currentBaseState. So, currentState is ultimate State of the List. displayIdentifier String List identifier in readable format with Prefix-Counter (integer). workItemTitle String Title of the list. dueDate Integer Due date of the list. dueDateFormatted String Formatted value of due in readable format. creationTimestamp DateTime Creation date time in milliseconds. creationTimestampFormatted DateTime Creation date time in readable format. lastModifiedTimestamp DateTime Last modified date time in milliseconds. lastModifiedTimestampFormatted DateTime Last modified date time in readable format. createdByUser Object Contains details of the user who created the work item. userName String User's name who created the workitem. userEmail String User's email who created the workitem. lastModifiedByUser Object Contains details of the user who modified the work item. userName String User's name who last updated the workitem. userEmail Integer User's email who last updated the workitem. initiatingCompany Object Contains the initiating company name, identifier type, and identifier value. primaryIdentifierType String Primary Identifier Type of Initiating company. primaryIdentifierValue String Primary Identifier Value of Initiating company. businessName String Business name of Initiating Company. assigneeCompany Object Contains the assignee company name, identifier type, and identifier value. primaryIdentifierType String Primary Identifier Type of assignee company. primaryIdentifierValue String Primary Identifier Value of assignee company. businessName String Business name of assignee Company. followers Object Contains the follower IDs. followerId String Following users GUID. #### Example
```plaintext
query WorkItemView {
workItem {
view(input: {id: "d972e6ec-5ec7-4d81-ac13-41aa40e60e64"}) {
id
currentBaseState
currentSubState
lastUpdatedDateTime
lastUpdatedDateTimeFormatted
data {
currentState
comments {
commentIdentifier
commentText
attachments
attachmentsFormatted
commentedDateTime
commentedDateTimeFormatted
commentAuthorId
commentAuthorIdFormatted
__typename
}
displayIdentifier
initiatingCompany {
primaryIdentifierType
primaryIdentifierValue
businessName
__typename
}
assigneeCompany {
primaryIdentifierType
primaryIdentifierValue
businessName
__typename
}
workItemTitle
dueDate
dueDateFormatted
followers {
followerId
followerIdFormatted
__typename
}
__typename
}
__typename
}
__typename
}
}
```
[View list response](#)#### Guidelines
Element Type Description Response Method - data Object - workItem - - view - - id String GUID of WorkItem. currentBaseState String Current Base State Value. currentSubState String Current Sub Base State Value if Sub workflows are activated. lastUpdatedDateTime Integer Last updated date time. lastUpdatedDateTimeFormatted String Last updated users GUID. data Object - currentState String This field will hold value of currentSubState if present, otherwise currentBaseState. So, currentState is ultimate State of the WorkItem. displayIdentifier String WorkItem identifier in readable format with Prefix-Counter (integer). workItemTitle String Title of the workItem. dueDate Integer Due date of the workItem. dueDateFormatted String Formatted value of due in readable format. creationTimestamp DateTime Creation date time in milliseconds. creationTimestampFormatted DateTime Creation date time in readable format. lastModifiedTimestamp DateTime Last modified date time in milliseconds. lastModifiedTimestampFormatted DateTime Last modified date time in readable format. createdByUser Object Contains details of the user who created the work item. userName String User's name who created the workitem. userEmail String User's email who created the workitem. lastModifiedByUser Object Contains details of the user who modified the work item. userName String User's name who last updated the workitem. userEmail Integer User's email who last updated the workitem. initiatingCompany Object Contains the initiating company name, identifier type, and identifier value. primaryIdentifierType String Primary Identifier Type of Initiating company. primaryIdentifierValue String Primary Identifier Value of Initiating company. businessName String Business name of Initiating Company. assigneeCompany Object Contains the assignee company name, identifier type, and identifier value. primaryIdentifierType String Primary Identifier Type of assignee company. primaryIdentifierValue String Primary Identifier Value of assignee company. businessName String Business name of assignee Company. followers Object Contains the follower IDs. followerId String Following users GUID. #### Example
```plaintext
{
"data": {
"workItem": {
"view": {
"id": "d972e6ec-5ec7-4d81-ac13-41aa40e60e64",
"currentBaseState": "ToDo",
"currentSubState": null,
"lastUpdatedDateTime": 1734860500367,
"lastUpdatedDateTimeFormatted": "12/22/24, 9:41 AM (GMT)",
"data": {
"currentState": "ToDo",
"comments": [
{
"commentIdentifier": "ac067728-ce20-437a-8c8e-bb305067eda3",
"commentText": "Added by partner",
"attachments": [
"{\"fileName\":\"Original_File\",\"fileExtension\":\"txt\",\"mimeType\":\"text/plain\",\"fileSize\":10,\"s3FileReference\":\"attachments/workItem/1eb0ddfc-a11b-4567-a929-55d3ef4d2d1f\",\"fileStatus\":\"UPLOADED\"}"
],
"attachmentsFormatted": [
"Original_File.txt (10 bytes)"
],
"commentedDateTime": 1734600804941,
"commentedDateTimeFormatted": "Dec 19, 2024, 9:33:24 AM (GMT)",
"commentAuthorId": "a3ef9f60-0276-11ed-ad1d-0242ac110011",
"commentAuthorIdFormatted": "Kaushal Lavate",
"__typename": "CommentTypeDefinition"
}
],
"displayIdentifier": "WI-79",
"initiatingCompany": {
"primaryIdentifierType": "GLN",
"primaryIdentifierValue": "2054051864409",
"businessName": "QAPartnerCorp1202409240834280621",
"__typename": "InitiatingCompanyLocationTypeDefinition"
},
"assigneeCompany": {
"primaryIdentifierType": "GLN",
"primaryIdentifierValue": "4700421709532",
"businessName": "QAOwnerCorp202409240834253301",
"__typename": "BusinessCompanyLocationTypeDefinition"
},
"workItemTitle": "Added by partner",
"dueDate": 1735205467366,
"dueDateFormatted": "Dec 26, 2024, 9:31:07 AM (GMT)",
"followers": [
{
"followerId": "a3ef9f60-0276-11ed-ad1d-0242ac110011",
"followerIdFormatted": "Matt Damon",
"__typename": "WorkItemFollowersTypeDefinition"
},
{
"followerId": "c55ff5ff-66d0-4c31-b2e4-5947a7e21955",
"followerIdFormatted": "Patricia Reynolds",
"__typename": "WorkItemFollowersTypeDefinition"
}
],
"__typename": "WorkItemData"
},
"__typename": "WorkItem"
},
"__typename": "WorkItemQueryOps"
}
}
}
```
#### Errors
This app uses [standard HTTP response codes](intro_to_apis.htm#http). If an error occurs, additional available information regarding the cause of the error is provided in the **errMsg** element in the relevant response.
#### Table of contents
##### Related Content
[  ](/resources/tracelink-university/forecast-plan-idoc)
##### Forecast plan (IDoc)
Forecasting APIs allow companies to exchange data about anticipated product demand and supply availability with upstream supply chain Partners without giving these Partners access to their serialization system of record.
[View More](/resources/tracelink-university/forecast-plan-idoc)
[  ](/resources/tracelink-university/forecast-plan-x12)
##### Forecast plan (X12)
Forecasting APIs allow companies to exchange data about anticipated product demand and supply availability with upstream supply chain Partners without giving these Partners access to their serialization system of record.
[View More](/resources/tracelink-university/forecast-plan-x12)
[  ](/resources/tracelink-university/forecast-plan-response-idoc)
##### Forecast plan response (IDoc)
Forecasting APIs allow companies to exchange data about anticipated product demand and supply availability with downstream supply chain Partners without giving these Partners access to their serialization system of record.
[View More](/resources/tracelink-university/forecast-plan-response-idoc)