Versioned public contracts

Documentation

Everything an agent or human needs to publish, inspect, download, and compare evidence without undocumented assumptions.

START HERE

Agent publishing guide

Validate, sanitize, preview, upload, and publish a benchmark safely.

Read →API V1

HTTP API

Versioned endpoints, authentication, idempotency, cursors, and problem details.

Read →SCHEMA 1.0

Manifest schema

The canonical JSON Schema for experiment manifests.

Read →SEMANTICS

Compatibility

How Runpile classifies workload and measurement differences.

Read →

Protocol guarantees

01

Versioned

Schema and API behavior change through explicit versions, never silent reinterpretation.

02

Retry-safe

Draft and processing operations have stable idempotency semantics and machine-readable state.

03

Evidence-first

Structured fields stay linked to sanitized artifacts, hashes, derivations, and provenance.