v2

latestOpenAPI 3.0.02026-08-013312111.4 MB
Search

Search for code in a workspace

This API will be deprecated on November 1, 2026.

Search for code in the repositories of the specified workspace.

Note that searches can match in the file's text (content_matches), the path (path_matches), or both.

You can use the same syntax for the search query as in the UI. E.g. to search for "foo" only within the repository "demo", use the query parameter search_query=foo+repo:demo.

Similar to other APIs, you can request more fields using a fields query parameter. E.g. to get some more information about the repository of matched files, use the query parameter search_query=foo&fields=%2Bvalues.file.commit.repository (the %2B is a URL-encoded +).

Try fields=%2Bvalues.*.*.*.* to get an idea what's possible.

get/workspaces/{workspace}/search/code

Path parameters

workspacestring required

The workspace to search in; either the slug or the UUID in curly braces

Query parameters

search_querystring required

The search query

pageinteger

Which page of the search results to retrieve

pageleninteger

How many search results to retrieve per page

Response

Successful search

sizeinteger
pageinteger
pageleninteger
query_substitutedboolean
nextstring uri
previousstring uri