---
title: "Create a runner pool"
method: POST
path: "/v1/orgs/{orgId}/runner-pools"
tags: ["Runners"]
---

# Create a runner pool

`POST /v1/orgs/{orgId}/runner-pools`

## Path parameters

- `orgId` string, required

## Request body

- CreateRunnerPoolRequest
  - `diskSizeGb` integer
  - `githubOwner` string
  - `githubOwnerType` string
  - `grant` string
  - `installationId` integer, required
  - `name` string
  - `poolRamGb` integer

## Response `200`

Created

- RunnerPool
  - `createdAt` string, required
  - `currentPeriodEnd` string
  - `diskSizeGb` integer, required
  - `githubInstallationId` integer, required
  - `githubOwner` string, required
  - `githubOwnerType` string, required
  - `id` string, required
  - `name` string, required
  - `organizationId` string, required
  - `poolRamGb` integer, required
  - `runtime` string
  - `status` string, required
  - `subscriptionStatus` string
  - `trialEndsAt` string
  - `updatedAt` string, required

## Other responses

- `400` — The request is invalid
- `401` — Missing or invalid API key
- `403` — API key lacks the required scope

---

[API](https://skmtc.net/openrelay/apis/openrelay-api.md) · [All operations](https://skmtc.net/openrelay/apis/openrelay-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openrelay/openrelay-api/versions/32905b8f44f8/schema)