---
title: "Gateway Check"
method: POST
path: "/api/v1/gateway/check"
tags: ["trust-gateway"]
---

# Gateway Check

`POST /api/v1/gateway/check`

## Request

- Base URL: `https://agentavow.com` (the document declares no server; this is the origin it was published from)
- URL: `https://agentavow.com/api/v1/gateway/check`
- Auth: none declared

Check trust tier for a tool and return an enforcement decision.

Agent frameworks call this before connecting to a tool. The response
includes whether the connection should be allowed, rate limits to apply,
and a signed JWS decision for audit trails.

Example::

    POST /api/v1/gateway/check
    {"repo": "crewAIInc/crewAI", "min_tier": "standard"}

    → {"allowed": true, "trust_tier": "verified",
       "scan_decision": {"decision": "safe", ...}, ...}

## Request body

- GatewayCheckRequest: Request to check trust for a tool before execution.
  - `repo` string, required
  - `action` string
  - `min_tier` string
  - `fail_on` string
  - `context` string, nullable
  - `include_external` boolean

## Response `200`

Successful Response

- GatewayDecision: Enforcement decision returned by the gateway.
  - `allowed` boolean, required
  - `repo` string, required
  - `trust_score` integer, required
  - `trust_tier` string, required
  - `grade` string
  - `decision_reason` string, required
  - `scan_decision` object
  - `recommended_limits` object, required
  - `category_scores` object
  - `external_signals` ExternalSignal[]
    - `provider` string, required
    - `type` string, required
    - `score` number, nullable
    - `tier` string, nullable
    - `verified` boolean
    - `error` string, nullable
  - `jws` string, nullable
  - `checked_at` string, required
  - `check_ms` number, required

## Other responses

- `422`: Validation Error

---

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