Workfront API to find Project by Reference Number | Community
Skip to main content
shaneg54236626
September 27, 2023
Solved

Workfront API to find Project by Reference Number

  • September 27, 2023
  • 2 replies
  • 1560 views

Hi everyone,

 

Is it possible to use the Workfront API to search/add to an existing project using the Ref # and how would that be structured in the URL?

 

Thank you,

Shane

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 ChrisStephens

You have to modify a project with the UID of the project, but you can for sure search for a project with the reference number, just add referenceNumber={your reference number} to your query string, replacing {your reference number} with the target reference number.

2 replies

Level 5
September 28, 2023

Do you mean the External Reference ID?  If so, it would be an API query that would just filter on that.  You can either use the regular Search module or a Custom API module.  The query parameter would be extRefID and the value would just be the value you'd want.  You can also use the regular _Mod modifiers.  (I've found https://github.com/Workfront/workfront-api-constants/blob/master/src/constants.ts to be a really useful resource for seeing those.)

Example query set:

  • extRefID_Mod=cicontains
  • extRefID=SomeSubstringValue

Setting would just be updating the same object to have an extRefID value.

Hope that helps!

ChrisStephens
Community Advisor
ChrisStephensCommunity AdvisorAccepted solution
Community Advisor
September 28, 2023

You have to modify a project with the UID of the project, but you can for sure search for a project with the reference number, just add referenceNumber={your reference number} to your query string, replacing {your reference number} with the target reference number.

Level 2
September 28, 2023

Dumb question as I am filling in on this product, but is the UID the ID that is a part of the URL string?

ChrisStephens
Community Advisor
Community Advisor
September 28, 2023

That's correct. In the API, the field is called "ID".