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=relevance to rank results by how closely they match your search query.
Who is affected
Developers using GET /workspaces/{workspace_gid}/projects/search who want results ordered by search relevance rather than a date-based field.
This is a non-breaking, additive change. Existing integrations that omit sort_by are unaffected — the default remains modified_at.
Usage
Pass sort_by=relevance as a query parameter alongside your other search filters:
// GET /workspaces/{workspace_gid}/projects/search?text=marketing&sort_by=relevance
The full set of accepted values for sort_by is now:
| Value | Description |
|---|---|
modified_at |
Sort by last modified date (default) |
due_date |
Sort by due date |
created_at |
Sort by creation date |
completed_at |
Sort by completion date |
relevance |
Sort by relevance to the search query |
Note: The search endpoint is only available to users in a premium workspace (Starter, Advanced, Enterprise, and Enterprise+ tiers), or members of a premium team within a workspace. Requests made with non-premium credentials will return a
402 Payment Requirederror. See Premium access in the API reference for details.
Timeline
This is available now.