Summary
Asana is updating its URL format in the web browser to improve readability and performance by adding human-readable segments to URLs.
**Current URL Format (V0)**
https://app.asana.com/0/1206043162733419/12058909747493732
**New URL Format (V1)**
https://app.asana.com/1/15793206719/project/1206043162733419/task/12058909747493732
All links in the browser will change once this is fully released, but the previous URL format (V0) will still be supported indefinitely.
This has no bearing on API endpoint formats: all API endpoints and their URIs will not be changed.
Who is affected
Apps that parse Asana URLs may need to update their logic to account for the new format.
Our upcoming release will include the following pages, with more pages potentially migrating to this format in the future:
- Tasks in a project
- Task stories (comments)
- Projects / project views
- Inbox
- Project create dialog (static)
- Project template gallery (static)
See the table below for more detail.
Change details
New V1 URL format
Logic to parse a IDs from a URL will need to be updated to accommodate the new URL format:
**Current Task URL (V0)**
https://app.asana.com/0/<project_id>/<task_id>
**New Task URL (V1)**
https://app.asana.com/1/<workspace_id>/project/<project_id>/task/<task_id>
**General V1 format**
https://app.asana.com/<url_format_version>/<workspace_id>/<object_name>/<object_id>/<subobject_name>/<subobject_id>
This new format has three defining characteristics:
- All object IDs will be preceded by an identifier segment / object type name, e.g. /project/123
<workspace_id>will be added in V1 URLs as a second parameter (after<url_format_version>/)- Some URLs don’t have any IDs at all and multiple static segments can exist in the sequence, e.g. /create-project/template-gallery or /project/123/timeline
Here are the specific objects we will change in the upcoming release. Others will follow this format in the future (goals, portfolios, etc), but will not be changed in the upcoming release.
| Object | New URL format |
|---|---|
| Project | /project/<project_id> |
| Task in a project | /project/<project_id>/task/<task_id> |
| Task comment in a project | /project/<project_id>/task/<task_id>/comment/<comment_id> |
| Project with named view | /project/<project_id>/<view_name> |
| Project with custom view | /project/<project_id>/view/<view_id> |
| Project with an LLM Question | /project/<project_id>/llmAskQuestion/<llmAskQuestion_id> |
| Project with an LLM Thread | /project/<project_id>/llmAgentThread/<llmAgentThread_id> |
| Home | /home |
| Task in Home | /home/task/<task_id> |
| Inbox | /inbox/<domainUser_id> |
| Inbox with an item and story | /inbox/<domainUser_id>/item/<item_id>/story/<story_id> |
| Create project dialog | /create-project |
| Project template gallery | /create-project/template-gallery |
Focus mode / Full screen view for tasks
Users may view a task in “focus” or full screen mode. In the current format (V0), these URLS have a /f at the end of the URL path. This will change to a query parameter ?focus=true in the new format (V1).
https://app.asana.com/1/15793206719/project/1206043162733419/task/12058909747493732?focus=true
Returning V1 URLs in the Asana API
Asana objects fetched via the API will reflect this new pattern in their permalink_url field.
GET /project/12345?&opt_fields=permalink_url,name,resource_type,gid
{
"data": {
"gid": "12345",
"resource_type": "project",
"name": "Winter Campaign Launch",
"permalink_url": "https://app.asana.com/1/9876543/project/12345" <<<<<
}
}
Previous URL format will continue to be supported
All existing URLs will still continue to be supported. There are no breaking changes for apps which store or create URLs in the old format. Old links will automatically “redirect” to the new URL structure.
Timeline
- Feb 17th 2025 - Gradual rollout will start for the objects described in this post
- Others will likely follow this format in the future (goals, portfolios, etc), but no change is currently planned for those pages.
- There is no plan to remove support for links using the existing V0 structure.
Questions
Thank you for your understanding as we continue to improve the Asana web app’s URL structure and overall platform performance. Please reply with questions or let us know how we can support you through this transition.
Edit 1: Add mention of focus mode
Edit 2: Adding workspace_id as a key characteristic of V1 URLs