---
title: "POST /api/connections/validate"
method: POST
path: "/api/connections/validate"
tags: ["connections"]
---

# POST /api/connections/validate

`POST /api/connections/validate`

## Request body

- object
  - `owner` 'org' | 'user', required
  - `integration` string, required
  - `template` string, required
  - `spec` object, nullable
    - `operation` string, required
    - `args` object, nullable
    - `identityField` string, nullable
  - `value` string, nullable
  - `values` object, nullable
  - `from` object, nullable
    - `provider` string, required
    - `id` string, required

## 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` — 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)