# API for Projects Custom Fields changes?

**URL:** <https://forum.asana.com/t/api-for-projects-custom-fields-changes/104369>\
**Category:** API & Developers\
**Tags:** custom-fields, projects\
**Created:** [30 December 2020 09:16 UTC](https://forum.asana.com/t/api-for-projects-custom-fields-changes/104369 "2020-12-30T09:16:47Z")\
**Posts on this page:** 8\
**Page:** 1

<div class="post-metadata">

**Author:** ![Carlo\_Burrafato](https://sea2.discourse-cdn.com/asana/user_avatar/forum.asana.com/carlo_burrafato/32/67534_2.png) [@Carlo\_Burrafato](https://forum.asana.com/u/Carlo_Burrafato)\
**Post date:** [30 December 2020 09:16 UTC](https://forum.asana.com/t/api-for-projects-custom-fields-changes/104369/1 "2020-12-30T09:16:47Z")

</div>

Hi everyone,

First post here in the Asana Comunity (and probably at all) so please let me know if I’m violating any policy…sorry if so.

I my company we’ve adopted Asana for almost a year now and we’re now starting to work with Asana APIs to retrieve data from the tool.

My question is: **is there any way to retrieve changes to project custom fields**? If so, which API(s) is to be called to obtain such information? I know it is possible to retrieve possibly any changes of a task (via “task/ {task\_gid} /stories”) but I’m struggling to find a way to do the same for projects and obtain a similar set of data back (date + old value + new value) as per the response of “Get a Story From a Task” ([Get stories from a task](https://developers.asana.com/docs/get-stories-from-a-task))

Basically, the objective is to have the changes date of the custom field “Project Status”, associated to every single project in the portfolio “Servizi Informativi”. In alternative, if there’s no API for this particular data, is it possible to retrieve the date the project has been archived?

I’ve searched in the API docs, but I did not faund anything similar to this.

Thanks in advance

Carlo

---

<div class="post-metadata">

**Author:** ![Bastien\_Siebman](https://sea2.discourse-cdn.com/asana/user_avatar/forum.asana.com/bastien_siebman/32/172354_2.png) [@Bastien\_Siebman](https://forum.asana.com/u/Bastien_Siebman)\
**Post date:** [30 December 2020 12:28 UTC](https://forum.asana.com/t/api-for-projects-custom-fields-changes/104369/2 "2020-12-30T12:28:04Z")

</div>

Hi,

> [@Carlo\_Burrafato](#):
>
> First post here in the Asana Comunity (and probably at all) so please let me know if I’m violating any policy…sorry if so.

Welcome! We are all very nice, don’t worry ❤

> [@Carlo\_Burrafato](#):
>
> is there any way to retrieve changes to project custom fields

The regular API will allow you to get that info, and you can poll it on a regular basis. If you want to be notified of changes, you need to look at the `webhooks` or `events ` in the doc. @Phil_Seeman is the expert here, I am sure he will jump in to help!

---

<div class="post-metadata">

**Author:** ![Phil\_Seeman](https://sea2.discourse-cdn.com/asana/user_avatar/forum.asana.com/phil_seeman/32/81525_2.png) [@Phil\_Seeman](https://forum.asana.com/u/Phil_Seeman)\
**Post date:** [30 December 2020 16:00 UTC](https://forum.asana.com/t/api-for-projects-custom-fields-changes/104369/3 "2020-12-30T16:00:53Z")

</div>

Hi @Carlo_Burrafato and welcome to the forum!

As @Bastien_Siebman said, `custom_fields` is a property of the `project` object and you can retrieve a project’s current custom fields and their values by getting that info for a project.

In terms of knowing when a project custom field changes, there’s no equivalent to the “get stories” endpoint you reference for a task (but be careful about how you use that endpoint, see below).

You will get a project-change event triggered when you change a project’s custom field value, so you can use either Events or Webhooks to be notified of changes in custom fields (you can set a filter on your webhooks so you only get notified about custom fields changing, not other properties of a project).

A word of caution on using the “get stories” endpoint - it’s not meant as a complete audit trail and can have gaps in it; see [this forum post](https://forum.asana.com/t/list-history-of-change-in-custom-fields-value-in-tasks/58520/3) for more.

Let us know if you have further questions or need more info on any of the above!

---

<div class="post-metadata">

**Author:** ![Carlo\_Burrafato](https://sea2.discourse-cdn.com/asana/user_avatar/forum.asana.com/carlo_burrafato/32/67534_2.png) [@Carlo\_Burrafato](https://forum.asana.com/u/Carlo_Burrafato)\
**Post date:** [30 December 2020 16:47 UTC](https://forum.asana.com/t/api-for-projects-custom-fields-changes/104369/4 "2020-12-30T16:47:11Z")

</div>

Hi @Phil_Seeman,  
thanks so much for the fast reply. I got both your points and will re-engeener my data extraction based on that.

Just a last info, will the deletion of a story generate a “deletion story” itself? This is not to “fill the gap” in task stories but at least to know “there’s a gap” (the second case you mentioned in the linked post, “stories consolidation”, is not an issue in my case).

Thanks again,  
Carlo

---

<div class="post-metadata">

**Author:** ![Phil\_Seeman](https://sea2.discourse-cdn.com/asana/user_avatar/forum.asana.com/phil_seeman/32/81525_2.png) [@Phil\_Seeman](https://forum.asana.com/u/Phil_Seeman)\
**Post date:** [30 December 2020 17:13 UTC](https://forum.asana.com/t/api-for-projects-custom-fields-changes/104369/5 "2020-12-30T17:13:44Z")

</div>

> [@Carlo\_Burrafato](#):
>
> will the deletion of a story generate a “deletion story” itself?

I wasn’t sure, so I just tested this - it does!

---

<div class="post-metadata">

**Author:** ![Carlo\_Burrafato](https://sea2.discourse-cdn.com/asana/user_avatar/forum.asana.com/carlo_burrafato/32/67534_2.png) [@Carlo\_Burrafato](https://forum.asana.com/u/Carlo_Burrafato)\
**Post date:** [30 December 2020 18:30 UTC](https://forum.asana.com/t/api-for-projects-custom-fields-changes/104369/6 "2020-12-30T18:30:04Z")

</div>

@Phil_Seeman thanks a lot!

top support 🙂

Have a happy new year!!

Carlo

---

<div class="post-metadata">

**Author:** ![Bastien\_Siebman](https://sea2.discourse-cdn.com/asana/user_avatar/forum.asana.com/bastien_siebman/32/172354_2.png) [@Bastien\_Siebman](https://forum.asana.com/u/Bastien_Siebman)\
**Post date:** [31 December 2020 09:02 UTC](https://forum.asana.com/t/api-for-projects-custom-fields-changes/104369/7 "2020-12-31T09:02:33Z")

</div>

I told you he is the best 😍

---

<div class="post-metadata">

**Author:** ![system](https://sea2.discourse-cdn.com/asana/user_avatar/forum.asana.com/system/32/276370_2.png) [@system](https://forum.asana.com/u/system)\
**Post date:** [30 May 2025 18:55 UTC](https://forum.asana.com/t/api-for-projects-custom-fields-changes/104369/8 "2025-05-30T18:55:38Z")

</div>


