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

# Gateway Check

`POST /gateway/check`

## Request

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

Sends one request through your gateway key and reports `ok`, or the first thing that
stops an evaluation (or, with a training `use`, a training) run on its traffic, with what
to do. A refused key is that first failure (`credential`), not a 401.

## Request body

- CheckIn
  - `model` string, required
  - `use` 'eval_only' | 'decider_sft' | 'vla_finetune' | 'distillation' | 'preference_rl'
  - `api` 'openai' | 'anthropic' | 'google', nullable

## Response `200`

Successful Response

- CheckResult
  - `ok` boolean, required
  - `failure` 'credential' | 'unsupported_model' | 'schema' | 'upstream' | 'consent' | 'insufficient_data', nullable
  - `detail` string, nullable
  - `have` integer, nullable
  - `need` integer, nullable
  - `upstream` string, nullable
  - `upstream_status` integer, nullable

## Other responses

- `422`: Validation Error

---

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