Sign in

v18

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-014211,6201.8 MB
gitpod.v1.RunnerService

SearchRepositories

Searches for repositories across all authenticated SCM hosts.

Use this method to:

  • List available repositories
  • Search repositories by name or content
  • Discover repositories for environment creation

Returns repositories from all authenticated SCM hosts in natural sort order. If no repositories are found, returns an empty list.

Examples

  • List all repositories:

    Returns up to 25 repositories from all authenticated hosts.

    runnerId: "d2c94c27-3b76-4a42-b88c-95a85e392c68"

  • Search repositories:

    Searches for repositories matching the query across all hosts.

    runnerId: "d2c94c27-3b76-4a42-b88c-95a85e392c68"
searchString: "my-project"
limit: 10
post/gitpod.v1.RunnerService/SearchRepositories

Request body

limitinteger

Maximum number of repositories to return. Default: 25, Maximum: 100 Deprecated: Use pagination.page_size instead

runnerIdstring uuid
scmHoststring

The SCM's host to retrieve repositories from

searchMode'SEARCH_MODE_UNSPECIFIED' | 'SEARCH_MODE_KEYWORD' | 'SEARCH_MODE_NATIVE'
searchStringstring

Search query - interpretation depends on search_mode

Response

Success

lastPageinteger

Deprecated: Use pagination token instead. Total pages can be extracted from token.