v18

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

ListRunners

Lists all registered runners with optional filtering.

Use this method to:

  • View all available runners
  • Filter by runner type
  • Monitor runner status
  • Check runner availability

Examples

  • List all runners:

    Shows all runners with pagination.

    pagination:
      pageSize: 20
    
  • Filter by provider:

    Lists only AWS EC2 runners.

    filter:
      providers: ["RUNNER_PROVIDER_AWS_EC2"]
    pagination:
      pageSize: 20
    
post/gitpod.v1.RunnerService/ListRunners

Query parameters

pageSizeinteger
tokenstring

Request body

Response

Success