---
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' | '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
  - `responseSample` object[], nullable
    - `path` string, required
    - `value` string, required

## Other responses

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

---

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