---
title: "Generate runner credentials"
method: POST
path: "/runners/credentials"
---

# Generate runner credentials

`POST /runners/credentials`

Uses your current authentication context to generate runner credentials that are used for authenticating runner requests

## Response `200`

OK

- GenerateRunnerCredentialsResponse
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `credentials` RunnerCredentials, required
    - `certificate` string, required — The signed certificate used by the runner to authenticate itself to Tower.
    - `private_key` string, required — The private key used by the runner to authenticate itself to Tower.
    - `root_ca` string, nullable, required — The PEM encoded root CA certificate that is used to verify the runner's certificate when Tower is responsible for signing server certs.
    - `runner_service_url` string, required — The host of the runner service that this runner will connect to. This is typically the Tower service host.

## Other responses

- `default` — Error

---

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