---
title: "Mint a just-in-time runner"
method: POST
path: "/api/actions/provider/v1/jit"
tags: ["Actions"]
---

# Mint a just-in-time runner

`POST /api/actions/provider/v1/jit`

## Request

- Base URL: `https://git.cafe`
- URL: `https://git.cafe/api/actions/provider/v1/jit`
- Auth: HTTP bearer

Creates an ephemeral runner in the token's pool, optionally bound to one queued job of that pool, and returns its credentials once as a JIT config.

## Request body

- object
  - `name` string
  - `jobId` string
  - `os` 'linux' | 'macos' | 'windows'
  - `arch` 'x64' | 'arm64'
  - `agent` 'actions'
  - `labels` string[]

## Response `201`

Response for status 201

- object
  - `agent` 'actions', required
  - `runnerId` string, required
  - `agentId` integer, required
  - `name` string, required
  - `encodedJitConfig` string, required

## Other responses

- `400`: Response for status 400
- `401`: Response for status 401
- `404`: Response for status 404
- `409`: Response for status 409
- `503`: Response for status 503

---

[API](https://skmtc.dev/gitcafe/apis/git-cafe-api.md) - [All operations](https://skmtc.dev/gitcafe/apis/git-cafe-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gitcafe/apis/git-cafe-api/revisions/9fa233d2986d?raw)