---
title: "Check connectors that have no stored status"
method: POST
path: "/v1/mcp-connections/readiness-checks"
tags: ["Capability Sources"]
---

# Check connectors that have no stored status

`POST /v1/mcp-connections/readiness-checks`

## Request

- Base URL: `https://api.openworklabs.com`
- URL: `https://api.openworklabs.com/v1/mcp-connections/readiness-checks`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

For an admin's connector list. For each listed connector with no stored status: copies any member's still-valid Ready check onto a per-member connector, otherwise checks it (initialize and tools/list, no tools executed) with the shared credential or the caller's own sign-in. Connectors that already have a status are left alone; use the per-connection check to re-check one. Requires connections.manage.

## Request body

- ExternalMcpReadinessChecksRequest
  - `connectionIds` string[], required

## Response `200`

What happened to each connector.

- ExternalMcpReadinessChecksResponse
  - `results` object[], required
    - `connectionId` string, required
    - `outcome` 'copied_from_member' | 'checked' | 'already_checked' | 'not_checkable' | 'not_found', required: copied_from_member: a member's Ready check was copied to the connector. checked: a check ran and was recorded (Ready or not). not_checkable: nobody with a working sign-in has checked it and the caller cannot check it themselves.

## Other responses

- `400`: Invalid request.
- `401`: Sign in required.
- `403`: Connection management permission required.

## Changes

- **2026-10-23** `c93387179b31`: 1 info
  - response property `details/items/path/items/` list-of-types was narrowed by removing types `number` from media type `application/json` of response `400`
- **2026-10-22** `6cd7fffc8d0b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/openworklabs/apis/den-api/changes/v1/mcp-connections/readiness-checks/post.md)

---

[API](https://skmtc.dev/openworklabs/apis/den-api.md) - [All operations](https://skmtc.dev/openworklabs/apis/den-api/llms.txt) - [OpenAPI document](https://skmtc.dev/openworklabs/apis/den-api/revisions/8170cf4a92ca?raw)