Sign in

v18

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

ListSCMOrganizations

Lists SCM organizations the user belongs to.

Use this method to:

  • Get all organizations for a user on a specific SCM host
  • Check organization admin permissions for webhook creation

Examples

  • List GitHub organizations:

    Lists all organizations the user belongs to on GitHub.

    runnerId: "d2c94c27-3b76-4a42-b88c-95a85e392c68"
scmHost: "github.com"

  • Search GitLab groups:

    Returns the first page of GitLab groups matching the substring.

    runnerId: "d2c94c27-3b76-4a42-b88c-95a85e392c68"
scmHost: "gitlab.com"
query: "platform"
pagination:
  pageSize: 25
post/gitpod.v1.RunnerService/ListSCMOrganizations

Query parameters

pageSizeinteger
tokenstring

Request body

querystring

Optional substring filter applied to the organization name.

  • GitLab: forwarded to the upstream search parameter (server-side, case-insensitive substring on name/path).
  • GitHub and Bitbucket: not implemented as they don't support searching Empty value means no filter.
runnerIdstring uuid
scmHoststring

The SCM host to list organizations from (e.g., "github.com", "gitlab.com")

Response

Success