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/runs): one row per AI Studio run (rule execution), including what ran, who owns it, the model used, and the credits consumed. Seats (/workspaces/{workspace_gid}/ai_studio/seats): a cu…
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 stay informed, and check the entries below for the latest additions. Current entries: Creation Permissions: create_project, create_goal, create_portfolio, create_read_only_link, sha…
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 Search tasks in a workspace endpoint. Previously, project search results could only be sorted by due_date, created_at, completed_at, or modified_at. You can now pass sort_by=relevan…
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 require an opt-in header (Asana-Enable: ai_teammate_actors). This is the first in a phased rollout. Future phases will expand agent support to attribution fields (created_by, compl…
[ 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 model from a single, read-only date range to a flexible, multi-entry system with full CRUD support. As part of this change, the vacation_dates object (containing start_on and end_on)…
[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 visibility with privacy_setting Set a default member access level with default_access_level Read and post goal comments programmatically using two new goal stories endpoints These are additiv…
[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_subtype now accepts "custom" as a value, allowing you to scope search results to custom tasks only. A new parameter, custom_types.{CUSTOM_TYPE_GID}.custom_type_status_option.gid, al…
[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 give managers enhanced visibility into how time is being spent across their teams, enabling more granular reporting and filtering. This update introduces a new TimeTrackingCategor…
[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 deleting memberships. Responses for memberships belonging to a Custom Task Type include a new resource_subtype value: custom_type_membership. Custom Task Types are reusable task co…
[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 project it contains, specifically exposing the ability to manage permission inheritance. This is designed as a standalone resource to model the many-to-many relationship between proj…
[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 by name, membership, custom fields, and date ranges, using the same filtering capabilities available in Asana’s web app search. Who is affected? This change applies to developers b…
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 on a per-week basis (Monday-Sunday UTC) Transition timesheets through approval states: DRAFT → SUBMITTED → APPROVED (or REJECTED) Filter time tracking entries by their associated time…
[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 to reduce setup friction for repeated workflows. Why we’re making this change Creating portfolios from scratch can be a manual, time-consuming process—especially when reconfiguring…
[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 delete standard and custom roles within a domain. These endpoints provide the necessary infrastructure to manage centralized permissions and resolve role IDs found in audit log eve…
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 seamless synchronization of people data from external HR systems directly into Asana. With these new endpoints, you can now sync employee attributes like location, start date, dep…
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 date field, so you can retrieve entries within a specific date range without client-side filtering. This is a non-breaking change. The new parameters are optional, and existing req…
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 authorizations. The previous beta release of the MCP server (now referred to as V1) is deprecated as of today and will be shut down in 3 months. The V1 redirect URI allowlist is frozen, so al…
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 entries to help you better understand their approval workflow state, billing implications, and user-provided details. They are currently read-only. What’s new The following fields are no…
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 dimensions. With this new API functionality, developers can: Programmatically create and configure project budgets and custom rates Pull budget data including actual time and costs s…
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 goals support most field types including text, number, enum (single-select), multi-enum (multi-select), date, and people fields. Why we’re making this change This change benefits develo…
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 separate API calls for each task or project. What’s new You can now query time tracking entries using these new optional parameters: Parameter Type Description attributable_to str…
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 access to private work and allow admins to approve or reject those requests directly through the API. Who benefits This is a new feature that affects developers building integratio…
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 other Asana objects like projects and portfolios. As part of this change, today’s editor role will effectively be renamed to admin. The editor role will lose setup and structure ca…
Summary We’re introducing a new POST /exports/resource endpoint that allows bulk export of tasks, teams, and messages using an Asana service account. This endpoint provides a standardized way to extract large datasets from your Asana workspace without making thousands of individual API requests. Resource Export API Reference What’s new The /exports/resource endpoint enables you to: Export multiple…
Summary We’re deprecating Limited Access Members (LAMs) to simplify team membership and improve security. LAMs are users who currently receive limited team access implicitly through project membership, without being full team members. Starting in October 2025, this automatic team access will be removed. This change is an important milestone for removing the association between teams and projects w…
Summary Asana will soon support reference custom fields that store references to other Asana objects like tasks, projects, portfolios, and goals. This new custom field type allows you to create structured relationships between objects in your Asana workspace through the API. Key benefits: Create structured relationships between Asana objects Configure which object types can be referenced per field…
Summary We are migrating profile photo hosting to our Content Delivery Network (CDN) for improved performance and security. This change does not affect any API endpoints or behaviors — only the format of the profile photo URLs returned by endpoints such as GET /users/{user_gid}. The images themselves, including formats and available resolutions, remain unchanged. Current URL example https://s3.us-…