---
title: "POST /api/mcp/codex-plugins/{id}/check"
method: POST
path: "/api/mcp/codex-plugins/{id}/check"
tags: ["mcp"]
---

# POST /api/mcp/codex-plugins/{id}/check

`POST /api/mcp/codex-plugins/{id}/check`

## Request

- Base URL: `https://executor.sh` (the document declares no server; this is the origin it was published from)
- URL: `https://executor.sh/api/mcp/codex-plugins/{id}/check`
- Auth: none required

## Path parameters

- `id` string, required

## Response `200`

Success

- object
  - `status` 'ok' | 'blocked' | 'not-installed' | 'nothing-to-check' | 'unknown' | 'unsupported', required
  - `message` string, nullable

## Other responses

- `500`: InternalError

## Changes

- **2026-09-03** `6387e4c0e03a`: 1 info
  - added the optional property `retryable` to the response with the `500` status
- **2026-08-30** `f1ecedaa204c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/executor/apis/executor-api/changes/api/mcp/codex-plugins/:id/check/post.md)

---

[API](https://skmtc.dev/executor/apis/executor-api.md) - [All operations](https://skmtc.dev/executor/apis/executor-api/llms.txt) - [OpenAPI document](https://skmtc.dev/executor/apis/executor-api/revisions/57797c62321c?raw)