---
title: "Vérifier une connexion, dont GitHub en lecture seule"
method: POST
path: "/api/v1/connections/{id}/health-check"
tags: ["Control Plane"]
---

# Vérifier une connexion, dont GitHub en lecture seule

`POST /api/v1/connections/{id}/health-check`

## Request

- Base URL: `https://arcadeops.leadalpes.fr`
- URL: `https://arcadeops.leadalpes.fr/api/v1/connections/{id}/health-check`
- Auth: none declared

Retourne soit le diagnostic distant GitHub auditable, soit l’état V0 explicitement non vérifié d’un connecteur sans adaptateur.

## Path parameters

- `id` string, required

## Response `200`

Diagnostic de connexion

- union
  - object
    - `id` string, required
    - `resourceId` string, nullable, required
    - `state` 'UNKNOWN' | 'VERIFIED_HEALTHY' | 'DEGRADED' | 'AUTH_EXPIRED' | 'ACCESS_DENIED' | 'NOT_FOUND' | 'RATE_LIMITED' | 'ERROR', required
    - `status` string, required
    - `verified` boolean, required
    - `checkedAt` string, date-time, required
    - `verificationSource` 'GITHUB_API', required
    - `failureCode` string, nullable, required
    - `retryAfter` string, date-time, nullable, required
    - `evidenceDigest` string, required
    - `cacheExpiresAt` string, date-time, required
    - `cached` boolean, required
    - `maskedIdentity` string, nullable, required
    - `defaultBranch` string, nullable, required
    - `observedCommit` string, nullable, required
    - `agentAccess` 'READ_ONLY', required
    - `externalWrites` 'DISABLED', required
    - `detail` string, required
  - object
    - `checkedAt` string, date-time, required
    - `detail` string, required
    - `id` string, required
    - `status` string, required
    - `verified` false, required

---

[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)