---
title: "Run a stored eval snippet"
method: POST
path: "/hub/eval"
tags: ["Eval snippets"]
---

# Run a stored eval snippet

`POST /hub/eval`

## Request

- Base URL: `https://api.quiva.ai`
- URL: `https://api.quiva.ai/hub/eval`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/quivaworks/apis/quiva-ai-gateway-3/docs/hub/eval/post.ts> (a function with typed inputs; its response is checked against the schema)

Runs a snippet stored on the account by id, with a bounded deadline. Never runs code taken from the request. The result is flat at the top of the body.

## Request body

- object
  - `id` string, required
  - `input` unknown
  - `deadline_ms` integer

## Response `200`

Success

- object

## Other responses

- `400`: Request refused or invalid

## Changes

- **2026-11-12** `8730377687f9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/quivaworks/apis/quiva-ai-gateway-3/changes/hub/eval/post.md)

---

[API](https://skmtc.dev/quivaworks/apis/quiva-ai-gateway-3.md) - [All operations](https://skmtc.dev/quivaworks/apis/quiva-ai-gateway-3/llms.txt) - [OpenAPI document](https://skmtc.dev/quivaworks/apis/quiva-ai-gateway-3/revisions/f80cd5f3ac1c?raw)