---
title: "POST /api/connections/{owner}/{integration}/{name}/health"
method: POST
path: "/api/connections/{owner}/{integration}/{name}/health"
tags: ["connections"]
---

# POST /api/connections/{owner}/{integration}/{name}/health

`POST /api/connections/{owner}/{integration}/{name}/health`

## Path parameters

- `owner` 'org' | 'user', required
- `integration` string, required
- `name` string, required

## Query parameters

- `ifStaleMs` string, nullable

## Response `200`

Success

- object
  - `status` 'healthy' | 'expired' | 'misconfigured' | 'degraded' | 'unknown', required
  - `httpStatus` union
    - number
    - 'NaN'
    - 'Infinity'
    - '-Infinity'
    - 'Infinity' | '-Infinity' | 'NaN'
  - `identity` string, nullable
  - `checkedAt` union, required
    - number
    - 'NaN'
    - 'Infinity'
    - '-Infinity'
    - 'Infinity' | '-Infinity' | 'NaN'
  - `detail` string, nullable
  - `reason` 'credential_missing' | 'credential_refresh_rejected' | 'blocked_by_admin' | 'probe_timeout' | 'probe_failed' | 'upstream_status' | 'tool_sync_failed', nullable
  - `responseSample` object[], nullable
    - `path` string, required
    - `value` string, required

## Other responses

- `404` — ConnectionNotFoundError | IntegrationNotFoundError
- `500` — InternalError

---

[API](https://skmtc.dev/executor/apis/executor-api.md) · [All operations](https://skmtc.dev/executor/apis/executor-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/executor/executor-api/revisions/03ae66214fb3/schema)