---
title: "List PlanRunnerGroups"
method: GET
path: "/orgs/{orgName}/plan-runnergroups"
tags: ["PlanRunnerGroups"]
---

# List PlanRunnerGroups

`GET /orgs/{orgName}/plan-runnergroups`

## Request

- Base URL: `https://api.signadot.com/api/v2`
- URL: `https://api.signadot.com/api/v2/orgs/{orgName}/plan-runnergroups`
- Auth: API key in header `signadot-api-key`

List PlanRunnerGroups.

## Path parameters

- `orgName` string, required

## Response `200`

OK

- PlanRunnerGroup[]
  - `createdAt` string
  - `deletedAt` string
  - `name` string
  - `spec` PlanRunnerGroupSpec
    - `cache` PlanRunnerGroupCacheSpec
      - `size` string: Size is the requested PVC capacity, e.g. "10Gi".
      - `storageClass` string: StorageClass is the Kubernetes storage class name. Empty string uses the cluster default.
    - `cluster` string
    - `description` string
    - `image` string
    - `labels` object
    - `podTemplate` unknown
    - `scaling` PlanRunnerGroupScaling
      - `manual` PlanRunnerGroupManualScaling
        - `desiredPods` integer
  - `status` PlanRunnerGroupStatus
    - `pods` PlanRunnerGroupPodsStatus
      - `notReady` integer
      - `ready` integer
  - `updatedAt` string

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `502`: Bad Gateway

## Changes

- **2026-05-07** `942b3992433f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/signadot/apis/signadot-api/changes/orgs/:orgName/plan-runnergroups/get.md)

---

[API](https://skmtc.dev/signadot/apis/signadot-api.md) - [All operations](https://skmtc.dev/signadot/apis/signadot-api/llms.txt) - [OpenAPI document](https://skmtc.dev/signadot/apis/signadot-api/revisions/5e80b0f9c718?raw)