# Changelog

**URL:** https://forum.asana.com/c/forum-en/api/api-changelog/204.md

[Latest](https://forum.asana.com/latest.md) · [Categories](https://forum.asana.com/categories.md) · [Tags](https://forum.asana.com/tags.md)

---

## [About the changelog](https://forum.asana.com/t/about-the-changelog/634496)

<div class="topic-metadata">

**Author:** [@Jeff\_Schneider](https://forum.asana.com/u/Jeff_Schneider)\
**Replies:** 0\
**Last updated:** [13 December 2023 19:51 UTC](https://forum.asana.com/t/about-the-changelog/634496 "2023-12-13T19:51:01Z")

</div>

The changelog forum category is the single source of truth for new endpoints, improvements, and changes to the Asana API. What’s in the changelog? We’re committed to keeping this category updated with the latest informa…

---

## [\[New\] Rich text support for text custom fields](https://forum.asana.com/t/new-rich-text-support-for-text-custom-fields/1158354)

<div class="topic-metadata">

**Author:** [@Darya\_Selivanava](https://forum.asana.com/u/Darya_Selivanava)\
**Replies:** 0\
**Last updated:** [13 October 2026 11:29 UTC](https://forum.asana.com/t/new-rich-text-support-for-text-custom-fields/1158354 "2026-10-13T11:29:09Z")

</div>

Summary Text-type custom fields now support rich text content (bold, italic, underline, links, etc.) through the API. A new html\_text\_value response field surfaces the rich text HTML content of text custom fields on…

---

## [\[New\] Time tracking entry assignee field](https://forum.asana.com/t/new-time-tracking-entry-assignee-field/1158064)

<div class="topic-metadata">

**Author:** [@Dominik\_Brdak](https://forum.asana.com/u/Dominik_Brdak)\
**Replies:** 1\
**Last updated:** [9 October 2026 11:19 UTC](https://forum.asana.com/t/new-time-tracking-entry-assignee-field/1158064 "2026-10-09T11:19:34Z")

</div>

Summary Time tracking entries now expose an assignee field: the user whose timesheet the entry’s logged time is attributed to. Until now, the only user on a time tracking entry was created\_by, which identifies who creat…

---

## [\[New\] Pagination for SCIM Users and Groups Endpoints](https://forum.asana.com/t/new-pagination-for-scim-users-and-groups-endpoints/1157938)

<div class="topic-metadata">

**Author:** [@Mikhail\_Melikhov](https://forum.asana.com/u/Mikhail_Melikhov)\
**Replies:** 0\
**Last updated:** [8 October 2026 11:33 UTC](https://forum.asana.com/t/new-pagination-for-scim-users-and-groups-endpoints/1157938 "2026-10-08T11:33:48Z")

</div>

Summary Both GET /scim/Users and GET /scim/Groups can now return paginated results. Paging is opt-in: send startIndex and count, or cursor to enable pagination. If you do not send those parameters, the call returns the f…

---

## [\[New\] Subtask Date Rollups API support](https://forum.asana.com/t/new-subtask-date-rollups-api-support/1156811)

<div class="topic-metadata">

**Author:** [@Dominik\_Brdak](https://forum.asana.com/u/Dominik_Brdak)\
**Replies:** 2\
**Last updated:** [29 September 2026 11:09 UTC](https://forum.asana.com/t/new-subtask-date-rollups-api-support/1156811 "2026-09-29T11:09:15Z")

</div>

Summary Asana tasks can be organized into deep subtask hierarchies, but a parent task’s dates have always been independent of its subtasks’ dates. A parent could be due March 15 while a subtask ran to March 20, and nothi…

---

## [\[ Upcoming \] Enhanced custom type support for projects and portfolios, plus new custom\_type filtering](https://forum.asana.com/t/upcoming-enhanced-custom-type-support-for-projects-and-portfolios-plus-new-custom-type-filtering/1153530)

<div class="topic-metadata">

**Author:** [@Darya\_Selivanava](https://forum.asana.com/u/Darya_Selivanava)\
**Replies:** 4\
**Last updated:** [3 September 2026 01:31 UTC](https://forum.asana.com/t/upcoming-enhanced-custom-type-support-for-projects-and-portfolios-plus-new-custom-type-filtering/1153530 "2026-09-03T01:31:58Z")

</div>

Summary We’re extending custom types beyond custom task types to also support custom projects and portfolios. With this release, you can: Look up custom types across an entire workspace, not just within a single proje…

---

## [\[New\] Subtasks now expose inherited project memberships in the API](https://forum.asana.com/t/new-subtasks-now-expose-inherited-project-memberships-in-the-api/1151597)

<div class="topic-metadata">

**Author:** [@Dominik\_Brdak](https://forum.asana.com/u/Dominik_Brdak)\
**Replies:** 4\
**Last updated:** [11 August 2026 19:19 UTC](https://forum.asana.com/t/new-subtasks-now-expose-inherited-project-memberships-in-the-api/1151597 "2026-08-11T19:19:54Z")

</div>

Summary In Asana, a subtask inherits its ancestor tasks’ project associations even when it has not been added to those projects directly. The web and desktop apps already show these inherited projects, but the API has on…

---

## [\[ New \] AI Studio Usage API](https://forum.asana.com/t/new-ai-studio-usage-api/1147044)

<div class="topic-metadata">

**Author:** [@anon16982376](https://forum.asana.com/u/anon16982376)\
**Replies:** 0\
**Last updated:** [2 July 2026 23:56 UTC](https://forum.asana.com/t/new-ai-studio-usage-api/1147044 "2026-07-02T23:56:02Z")

</div>

AI Studio Usage API Summary We’re adding programmatic access to AI Studio usage data through two new read-only endpoints under a new ai\_studio resource group: Credit utilization (/workspaces/{workspace\_gid}/ai\_studio/r…

---

## [\[ New \] Granular RBAC Permissions](https://forum.asana.com/t/new-granular-rbac-permissions/1147024)

<div class="topic-metadata">

**Author:** [@anon16982376](https://forum.asana.com/u/anon16982376)\
**Replies:** 0\
**Last updated:** [2 July 2026 18:55 UTC](https://forum.asana.com/t/new-granular-rbac-permissions/1147024 "2026-07-02T18:55:32Z")

</div>

Granular RBAC Permissions This is the canonical thread for all RBAC permission additions to the RbacRole resource. As new permissions are introduced, they will be added here as dated entries. Subscribe to this topic to …

---

## [\[Change\] sort\_by=relevance now available on the Search Projects endpoint](https://forum.asana.com/t/change-sort-by-relevance-now-available-on-the-search-projects-endpoint/1143680)

<div class="topic-metadata">

**Author:** [@anon16982376](https://forum.asana.com/u/anon16982376)\
**Replies:** 0\
**Last updated:** [4 June 2026 22:50 UTC](https://forum.asana.com/t/change-sort-by-relevance-now-available-on-the-search-projects-endpoint/1143680 "2026-06-04T22:50:06Z")

</div>

Summary The Search projects in a workspace endpoint (GET /workspaces/{workspace\_gid}/projects/search) now supports sort\_by=relevance, bringing it to parity with both the Asana web app’s advanced search and the existing S…

---

## [\[Upcoming\] AI Teammates and Agent API Support](https://forum.asana.com/t/upcoming-ai-teammates-and-agent-api-support/1142767)

<div class="topic-metadata">

**Author:** [@anon16982376](https://forum.asana.com/u/anon16982376)\
**Replies:** 1\
**Last updated:** [6 October 2026 15:38 UTC](https://forum.asana.com/t/upcoming-ai-teammates-and-agent-api-support/1142767 "2026-10-06T15:38:46Z")

</div>

Summary You can now discover agents in a workspace, look up individual agent records, and assign tasks directly to an AI Teammate through both the REST API and the Asana MCP server. These changes are in Early Access and…

---

## [\[ New \] Out of Office API and deprecation of vacation\_dates](https://forum.asana.com/t/new-out-of-office-api-and-deprecation-of-vacation-dates/1138357)

<div class="topic-metadata">

**Author:** [@anon16982376](https://forum.asana.com/u/anon16982376)\
**Replies:** 0\
**Last updated:** [27 April 2026 14:35 UTC](https://forum.asana.com/t/new-out-of-office-api-and-deprecation-of-vacation-dates/1138357 "2026-04-27T14:35:24Z")

</div>

\[ New \] Out of Office API and deprecation of vacation\_dates Summary We are introducing the new OooEntry resource to the Asana API, enabling support for multiple out-of-office periods per user. This updates Asana’s OOO mo…

---

## [\[New\] Goals Now Support Privacy Settings, Default Access Levels, and Stories via API](https://forum.asana.com/t/new-goals-now-support-privacy-settings-default-access-levels-and-stories-via-api/1134896)

<div class="topic-metadata">

**Author:** [@anon16982376](https://forum.asana.com/u/anon16982376)\
**Replies:** 0\
**Last updated:** [6 April 2026 20:41 UTC](https://forum.asana.com/t/new-goals-now-support-privacy-settings-default-access-levels-and-stories-via-api/1134896 "2026-04-06T20:41:43Z")

</div>

\[New\] Goals Now Support Privacy Settings, Default Access Levels, and Stories via API Summary Goals now support privacy settings, default access levels, and stories via the Asana API. You can now: Control goal visibili…

---

## [\[New\] Enhanced filtering for custom task types in Search API](https://forum.asana.com/t/new-enhanced-filtering-for-custom-task-types-in-search-api/1134845)

<div class="topic-metadata">

**Author:** [@anon16982376](https://forum.asana.com/u/anon16982376)\
**Replies:** 2\
**Last updated:** [6 April 2026 17:18 UTC](https://forum.asana.com/t/new-enhanced-filtering-for-custom-task-types-in-search-api/1134845 "2026-04-06T17:18:47Z")

</div>

\[New\] Enhanced filtering for custom task types in Search API Summary Two new filtering capabilities are now available on the Search tasks in a workspace endpoint (GET /workspaces/{workspace\_gid}/tasks/search): resource…

---

## [\[New\] Categories for Time Tracking Entries](https://forum.asana.com/t/new-categories-for-time-tracking-entries/1134291)

<div class="topic-metadata">

**Author:** [@anon16982376](https://forum.asana.com/u/anon16982376)\
**Replies:** 0\
**Last updated:** [1 April 2026 20:29 UTC](https://forum.asana.com/t/new-categories-for-time-tracking-entries/1134291 "2026-04-01T20:29:30Z")

</div>

\[New\] Categories for Time Tracking Entries Summary The Asana API now supports Time Tracking Categories — a way to label time tracking entries with categories like “Development,” “Meetings,” or “Design Review.” Categories…

---

## [\[Change\] Custom Types Support in Memberships Endpoints](https://forum.asana.com/t/change-custom-types-support-in-memberships-endpoints/1134061)

<div class="topic-metadata">

**Author:** [@anon16982376](https://forum.asana.com/u/anon16982376)\
**Replies:** 0\
**Last updated:** [31 March 2026 20:19 UTC](https://forum.asana.com/t/change-custom-types-support-in-memberships-endpoints/1134061 "2026-03-31T20:19:06Z")

</div>

\[Change\] Custom Types Support in Memberships Endpoints Summary The /memberships endpoints now support Custom Task Types. You can use Custom Task Type GIDs as the parent parameter when creating, retrieving, updating, and …

---

## [\[New\] Project Portfolio Settings API](https://forum.asana.com/t/new-project-portfolio-settings-api/1132453)

<div class="topic-metadata">

**Author:** [@anon16982376](https://forum.asana.com/u/anon16982376)\
**Replies:** 0\
**Last updated:** [23 March 2026 16:30 UTC](https://forum.asana.com/t/new-project-portfolio-settings-api/1132453 "2026-03-23T16:30:05Z")

</div>

\[New\] Project Portfolio Settings’s New Endpoints and Webhooks Summary We are introducing the project\_portfolio\_setting resource to the Asana API. This new resource represents the relationship between a portfolio and a pr…

---

## [\[New\] Advanced Search for Projects](https://forum.asana.com/t/new-advanced-search-for-projects/1132444)

<div class="topic-metadata">

**Author:** [@anon16982376](https://forum.asana.com/u/anon16982376)\
**Replies:** 0\
**Last updated:** [23 March 2026 16:08 UTC](https://forum.asana.com/t/new-advanced-search-for-projects/1132444 "2026-03-23T16:08:50Z")

</div>

\[New\] Advanced Search for Projects Finding specific projects via the API previously required fetching large lists and filtering client-side. The new Advanced Project Search endpoint allows you to query projects directly …

---

## [\[New\] Timesheet Approval Status API](https://forum.asana.com/t/new-timesheet-approval-status-api/1132120)

<div class="topic-metadata">

**Author:** [@John\_Baldo](https://forum.asana.com/u/John_Baldo)\
**Replies:** 0\
**Last updated:** [20 March 2026 16:44 UTC](https://forum.asana.com/t/new-timesheet-approval-status-api/1132120 "2026-03-20T16:44:18Z")

</div>

Summary We’re introducing a new set of endpoints that let you programmatically manage weekly timesheet approval workflows in Asana. With this release, you can: Read and manage timesheet approval statuses for any user …

---

## [\[New\] Portfolio Duplication API](https://forum.asana.com/t/new-portfolio-duplication-api/1131158)

<div class="topic-metadata">

**Author:** [@anon16982376](https://forum.asana.com/u/anon16982376)\
**Replies:** 0\
**Last updated:** [16 March 2026 15:46 UTC](https://forum.asana.com/t/new-portfolio-duplication-api/1131158 "2026-03-16T15:46:56Z")

</div>

\[New\] Portfolio Duplication Summary You can now duplicate portfolios via the Asana API. This new endpoint allows you to create a new portfolio based on an existing one, carrying over specific settings and configurations…

---

## [\[New\] RBAC Role API Endpoints (CRUD)](https://forum.asana.com/t/new-rbac-role-api-endpoints-crud/1128143)

<div class="topic-metadata">

**Author:** [@anon16982376](https://forum.asana.com/u/anon16982376)\
**Replies:** 0\
**Last updated:** [27 February 2026 18:38 UTC](https://forum.asana.com/t/new-rbac-role-api-endpoints-crud/1128143 "2026-02-27T18:38:05Z")

</div>

\[New\] RBAC Role API Endpoints (CRUD) Summary We are introducing a suite of API endpoints to support Role-Based Access Control (RBAC) roles. This update allows developers to programmatically create, retrieve, update, and …

---

## [\[New\] Read and update custom fields on Users](https://forum.asana.com/t/new-read-and-update-custom-fields-on-users/1126306)

<div class="topic-metadata">

**Author:** [@John\_Baldo](https://forum.asana.com/u/John_Baldo)\
**Replies:** 2\
**Last updated:** [21 April 2026 14:37 UTC](https://forum.asana.com/t/new-read-and-update-custom-fields-on-users/1126306 "2026-04-21T14:37:38Z")

</div>

Summary We’re introducing API support for custom fields on users, allowing developers to programmatically read and update user custom field values, as well as retrieve team custom field settings. This enhancement enables…

---

## [\[New\] Filter time tracking entries by date range](https://forum.asana.com/t/new-filter-time-tracking-entries-by-date-range/1126286)

<div class="topic-metadata">

**Author:** [@John\_Baldo](https://forum.asana.com/u/John_Baldo)\
**Replies:** 0\
**Last updated:** [18 February 2026 21:14 UTC](https://forum.asana.com/t/new-filter-time-tracking-entries-by-date-range/1126286 "2026-02-18T21:14:49Z")

</div>

Summary We’re adding two new optional query parameters ( entered\_on\_start\_date and entered\_on\_end\_date) to the GET /time\_tracking\_entries endpoint. These parameters let you filter time tracking entries by the entered\_on …

---

## [\[New\] V2 MCP server now generally available!](https://forum.asana.com/t/new-v2-mcp-server-now-generally-available/1122647)

<div class="topic-metadata">

**Author:** [@John\_Baldo](https://forum.asana.com/u/John_Baldo)\
**Replies:** 48\
**Last updated:** [22 June 2026 20:00 UTC](https://forum.asana.com/t/new-v2-mcp-server-now-generally-available/1122647 "2026-06-22T20:00:41Z")

</div>

Summary The Asana MCP server is now generally available with the release of V2. This update introduces a new client registration model, an optimized tool set, support for Streamable HTTP, and workspace scoped authorizati…

---

## [\[New\] Time Tracking Entries API - Additional fields available](https://forum.asana.com/t/new-time-tracking-entries-api-additional-fields-available/1115003)

<div class="topic-metadata">

**Author:** [@John\_Baldo](https://forum.asana.com/u/John_Baldo)\
**Replies:** 5\
**Last updated:** [20 January 2026 15:47 UTC](https://forum.asana.com/t/new-time-tracking-entries-api-additional-fields-available/1115003 "2026-01-20T15:47:14Z")

</div>

Summary Three new fields are now available on all API requests that return TimeTrackingEntry entities: approval\_status, billable\_status, and description. These fields provide additional context about time tracking entrie…

---

## [\[New\] Project Budgets support in the Asana API](https://forum.asana.com/t/new-project-budgets-support-in-the-asana-api/1111287)

<div class="topic-metadata">

**Author:** [@John\_Baldo](https://forum.asana.com/u/John_Baldo)\
**Replies:** 0\
**Last updated:** [26 November 2025 18:43 UTC](https://forum.asana.com/t/new-project-budgets-support-in-the-asana-api/1111287 "2025-11-26T18:43:35Z")

</div>

Summary We’re bringing API support to Project Budgets, a critical component of Asana’s Resource Management Add-On. Project Budgets help teams monitor project financial health by tracking time and costs across multiple di…

---

## [\[New\] Custom fields on goals](https://forum.asana.com/t/new-custom-fields-on-goals/1111098)

<div class="topic-metadata">

**Author:** [@John\_Baldo](https://forum.asana.com/u/John_Baldo)\
**Replies:** 0\
**Last updated:** [25 November 2025 23:01 UTC](https://forum.asana.com/t/new-custom-fields-on-goals/1111098 "2025-11-25T23:01:37Z")

</div>

Summary Goals can now include custom fields through the Asana API, bringing the same powerful metadata capabilities that are available for projects and portfolios to your goal management workflows. Custom fields on goal…

---

## [\[New\] Time Tracking Entries API - Query by Project, Portfolio, or User](https://forum.asana.com/t/new-time-tracking-entries-api-query-by-project-portfolio-or-user/1099480)

<div class="topic-metadata">

**Author:** [@John\_Baldo](https://forum.asana.com/u/John_Baldo)\
**Replies:** 2\
**Last updated:** [26 November 2025 10:45 UTC](https://forum.asana.com/t/new-time-tracking-entries-api-query-by-project-portfolio-or-user/1099480 "2025-11-26T10:45:00Z")

</div>

Summary The GET /time\_tracking\_entries endpoint now supports filtering by project, portfolio, task, and user. This enhancement allows you to retrieve time tracking entries across multiple contexts without needing to make…

---

## [\[New\] Request access endpoints](https://forum.asana.com/t/new-request-access-endpoints/1089780)

<div class="topic-metadata">

**Author:** [@John\_Baldo](https://forum.asana.com/u/John_Baldo)\
**Replies:** 0\
**Last updated:** [14 August 2025 22:42 UTC](https://forum.asana.com/t/new-request-access-endpoints/1089780 "2025-08-14T22:42:57Z")

</div>

Summary We’re launching new API endpoints for Asana’s request access framework, allowing developers to programmatically manage access requests for private projects and portfolios. These endpoints enable users to request …

---

## [\[New/Change\] Goal Access Levels: Admin, Editor and Viewer](https://forum.asana.com/t/new-change-goal-access-levels-admin-editor-and-viewer/1089758)

<div class="topic-metadata">

**Author:** [@John\_Baldo](https://forum.asana.com/u/John_Baldo)\
**Replies:** 2\
**Last updated:** [18 February 2026 19:57 UTC](https://forum.asana.com/t/new-change-goal-access-levels-admin-editor-and-viewer/1089758 "2026-02-18T19:57:39Z")

</div>

Summary We’re expanding Goal access levels to include Viewer, Editor, and Admin (existing Editor role renamed), giving you more granular control over Goal permissions and aligning Goals with the access model used across…

[Next page](https://forum.asana.com/c/forum-en/api/api-changelog/204.md?page=1)
