---
title: "Pkg Guard Check"
method: POST
path: "/pkg-guard/check"
---

# Pkg Guard Check

`POST /pkg-guard/check`

## Request

- Base URL: `https://usemeridian.us` (the document declares no server; this is the origin it was published from)
- URL: `https://usemeridian.us/pkg-guard/check`
- Auth: none declared

23f21820 -- package-install verification gate.

Accepts a Bash command string (from the PreToolUse hook), extracts any
pip/npm/uvx install operations, and checks each package against its
registry (PyPI JSON API or npm registry). Returns a gate decision:
  - action: "allow" | "warn"
  - message: advisory text (empty when allow)
  - packages: list of extracted package names
  - results: per-package registry check details
  - allowlisted_all: true when every package was in the known-good allowlist

Fails open: any server-side error returns action="allow" so a Meridian
availability issue never permanently wedges an executor session.

## Request body

- PkgGuardRequest
  - `command` string, required

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/usemeridian/apis/meridian.md) · [All operations](https://skmtc.dev/usemeridian/apis/meridian/llms.txt) · [OpenAPI document](https://skmtc.dev/usemeridian/apis/meridian/revisions/f37a894bd374?raw)