---
title: "Get runner deployment instructions"
method: POST
path: "/runners/runner-pools/{poolId}/deployment-instructions"
tags: ["Self-Hosted Runners"]
---

# Get runner deployment instructions

`POST /runners/runner-pools/{poolId}/deployment-instructions`

Retrieves deployment instructions for setting up runners in a pool

## Path parameters

- `poolId` string, required

## Request body

- GetRunnerDeploymentInstructionsRequest
  - `initialCount` integer, required
  - `deploymentType` 'kubernetes' | 'docker' | 'binary', required — Type of deployment for runners

## Response `200`

Runner deployment instructions retrieved successfully

- string

## Other responses

- `400` — Bad Request Error
- `401` — Unauthorized Error
- `403` — Insufficient permissions
- `404` — Not Found Error
- `500` — Internal Server Error

---

[API](https://skmtc.net/firefly/apis/api-gateway.md) · [All operations](https://skmtc.net/firefly/apis/api-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/firefly/api-gateway/revisions/eea119b4113f/schema)