Workfront API Task Endpoint: Difference btwn dueDate & plannedCompletionDate | Community
Skip to main content
M
Mylah_D
July 22, 2023
Solved

Workfront API Task Endpoint: Difference btwn dueDate & plannedCompletionDate

  • July 22, 2023
  • 3 replies
  • 1070 views

Using the GET method for TASKS and want to retrieve the "Planned Completion Date" of a task shown here.

 

I noticed there is both dueDate and plannedCompletion Date in the API Explorer.

I'm assuming plannedCompletionDate is the value I want to retrieve but what does dueDate bring back and what do those Flags mean in the Due Date entry? 

 

vs.

 

 

Thank you!

 

 

This post is no longer active and is closed to new replies. Need help? Start a new post to ask your question.
Best answer by Rafal_Bainie

Hi Mylah,

one important difference that you can read from this is that 

dueDate has Read_only flag, which means you might not be able to update it. That can be a reason why you get this field as N/A.

For other differences I would check with support since WF documentation is not always explicit about certain details.

Best
R

3 replies

M
Mylah_DAuthor
July 22, 2023

******Edited to add*************

 

On a related note, I am also using the Task POST method to create new tasks, and I notice that when we pass a specific dueDate value to the API DueDate field, the task Planned Completion Date gets set to "N/A" and appears blank in any view. (you can see how it appears in Task Details from my screenshot above.)  This is actually ok from a user experience perspective, because any time an API call creates a new Task and if I don't pass any value for DueDate, the Planned Completion Date is set automatically to the Project Planned Completion (of 6/29/29), which is what we DON'T want. And so the due date I was passing is arbitrarily set to "Today+90D", which wasn't that accurate either. But I'd really like to understand better what's going on. Any insights into this behavior? 

M
Mylah_DAuthor
July 22, 2023

Finally, please also note that when I retrieve both dueDate and plannedCompletionDate I get the same value in the response ... matching the value the Task field Planned Completion Date.

 

My questions are now more motivated by curiosity than anything else, since the process is "working" enough, even if I don't completely understand it. Any insights into the differences (why the need for two separate fields?) and the observed behavior around posting Planned Completion Date would be of great help! Thanks. 🙂 

 

Rafal_Bainie
Community Advisor
Rafal_BainieCommunity AdvisorAccepted solution
Community Advisor
July 24, 2023

Hi Mylah,

one important difference that you can read from this is that 

dueDate has Read_only flag, which means you might not be able to update it. That can be a reason why you get this field as N/A.

For other differences I would check with support since WF documentation is not always explicit about certain details.

Best
R

    Terms & ConditionsAccessibility statement

    Loading footer...