# \[Change\] sort\_by=relevance now available on the Search Projects endpoint

**URL:** <https://forum.asana.com/t/change-sort-by-relevance-now-available-on-the-search-projects-endpoint/1143680>\
**Category:** Changelog\
**Tags:** projects-api, api\
**Created:** [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")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![anon16982376](https://luna1.co/8d76cd.png) [@anon16982376](https://forum.asana.com/u/anon16982376)\
**Post date:** [4 June 2026 22:50 UTC](https://forum.asana.com/t/change-sort-by-relevance-now-available-on-the-search-projects-endpoint/1143680/1 "2026-06-04T22:50:06Z")

</div>

## **Summary**

The [Search projects in a workspace](https://developers.asana.com/reference/searchprojectsforworkspace) 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](https://developers.asana.com/reference/searchtasksforworkspace) 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:

```auto

// 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 Required` error. See [Premium access](https://developers.asana.com/reference/searchprojectsforworkspace#user-content-premium-access) in the API reference for details.

## **Timeline**

This is available now.

## **Resources**

- [Search projects in a workspace — API Reference](https://developers.asana.com/reference/searchprojectsforworkspace)
- [Search tasks in a workspace — API Reference](https://developers.asana.com/reference/searchtasksforworkspace)