---
title: "Get PlanRunnerGroup settings"
method: GET
path: "/orgs/{orgName}/plan-runnergroup-settings"
tags: ["PlanRunnerGroups"]
---

# Get PlanRunnerGroup settings

`GET /orgs/{orgName}/plan-runnergroup-settings`

## Request

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

Returns cluster eligibility information with nested plan runner group data.

## Path parameters

- `orgName` string, required

## Response `200`

OK

- PlanRunnerGroupSettingsResponse
  - `clusters` PlanRunnerGroupClusterSettings[]
    - `cluster` string
    - `eligible` boolean
    - `notes` string[]
    - `runnerGroups` 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-runnergroup-settings/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)