---
title: "Pairer un runner local"
method: POST
path: "/api/v1/runners/pair"
tags: ["AI Workforce", "Runner local"]
---

# Pairer un runner local

`POST /api/v1/runners/pair`

## Request

- Base URL: `https://arcadeops.leadalpes.fr`
- URL: `https://arcadeops.leadalpes.fr/api/v1/runners/pair`
- Auth: none required

Consomme le token de pairage à usage unique porté dans le corps, puis délivre un certificat runner et l'ancre Ed25519 publique qui vérifie les réponses signées du control plane. Aucune authentification HTTP n'est utilisée sur ce bootstrap cryptographique.

## Request body

- RunnerPairingRequest
  - `token` string, required
  - `displayName` string, required
  - `publicKeySpkiBase64` string, required
  - `protocolVersion` 'arcade.runner.v0', required
  - `runnerVersion` string, required

## Response `201`

Runner pairé et certificat délivré

- RunnerCertificateResponse
  - `runnerId` string, required
  - `organizationId` string, required
  - `scopes` string[], required
  - `certificate` object, required
    - `schemaVersion` 'arcade.runner-certificate.v0', required
    - `certificateSerial` string, uuid, required
    - `runnerId` string, required
    - `organizationId` string, required
    - `keyId` string, required
    - `publicKeySpkiBase64` string, required
    - `issuerKeyId` string, required
    - `validFrom` string, date-time, required
    - `validUntil` string, date-time, required
    - `usages` string[], required
    - `signature` string, required
  - `trustAnchor` object, required
    - `keyId` string, required
    - `algorithm` 'Ed25519', required
    - `publicKeySpkiBase64` string, required

## Other responses

- `400`: Requête de pairage invalide
- `403`: Token de pairage invalide, expiré ou déjà consommé
- `413`: Corps de requête trop volumineux
- `429`: Limite de requêtes atteinte
- `503`: Racine de certificats runner indisponible

---

[API](https://skmtc.dev/leadalpes/apis/arcadeops-api.md) · [All operations](https://skmtc.dev/leadalpes/apis/arcadeops-api/llms.txt) · [OpenAPI document](https://skmtc.dev/leadalpes/apis/arcadeops-api/revisions/f10422ec7412?raw)