HUD · Schema
RolloutRunRequest
Single-trace launch. A ``trace_id`` names a new trace; one that already exists is refused.
CompanyArtificial IntelligenceReinforcement LearningAI EvaluationAI AgentsBenchmarksMachine LearningTraining Data
Properties
| Name | Type | Description |
|---|---|---|
| task_version_id | string | |
| model_id | string | |
| trace_id | object | |
| max_steps | integer | |
| trace_name | object | |
| runtime_config | object |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/hud-ai/json-schema/hud-ai-rollout-run-request-schema.json",
"title": "RolloutRunRequest",
"description": "Single-trace launch. A ``trace_id`` names a new trace; one that already exists is refused.",
"x-generated": "2026-11-10",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/hud-ai-rollouts-api-openapi.yml#/components/schemas/RolloutRunRequest",
"properties": {
"task_version_id": {
"type": "string",
"format": "uuid",
"title": "Task Version Id"
},
"model_id": {
"type": "string",
"format": "uuid",
"title": "Model Id"
},
"trace_id": {
"anyOf": [
{
"type": "string",
"format": "uuid"
},
{
"type": "null"
}
],
"title": "Trace Id"
},
"max_steps": {
"type": "integer",
"title": "Max Steps",
"default": 100
},
"trace_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Trace Name"
},
"runtime_config": {
"anyOf": [
{
"$ref": "#/$defs/SubmittedRuntimeConfig"
},
{
"type": "null"
}
]
}
},
"type": "object",
"required": [
"task_version_id",
"model_id"
],
"$defs": {
"SubmittedComposeDocument": {
"properties": {
"services": {
"additionalProperties": {
"$ref": "#/$defs/SubmittedComposeService"
},
"type": "object",
"minProperties": 1,
"title": "Services"
}
},
"additionalProperties": true,
"type": "object",
"required": [
"services"
],
"title": "SubmittedComposeDocument",
"description": "Normalized Compose document transported with a hosted runtime artifact."
},
"SubmittedComposeProject": {
"properties": {
"document": {
"$ref": "#/$defs/SubmittedComposeDocument"
},
"root": {
"anyOf": [
{
"$ref": "#/$defs/SubmittedComposeProjectRef"
},
{
"type": "null"
}
]
},
"service_access": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Service Access"
}
},
"additionalProperties": false,
"type": "object",
"required": [
"document"
],
"title": "SubmittedComposeProject",
"description": "Compose document and its optional environment source artifact."
},
"SubmittedComposeProjectRef": {
"properties": {
"compose_path": {
"type": "string",
"minLength": 1,
"title": "Compose Path"
}
},
"additionalProperties": false,
"type": "object",
"required": [
"compose_path"
],
"title": "SubmittedComposeProjectRef",
"description": "Build-context location inside the selected environment source artifact."
},
"SubmittedComposeService": {
"properties": {
"image": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "null"
}
],
"title": "Image"
},
"build": {
"anyOf": [
{},
{
"type": "null"
}
],
"title": "Build"
},
"user": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "User"
},
"environment": {
"additionalProperties": {
"type": "string"
},
"type": "object",
"title": "Environment"
},
"entrypoint": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"title": "Entrypoint"
},
"command": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"title": "Command"
},
"working_dir": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Working Dir"
},
"healthcheck": {
"anyOf": [
{},
{
"type": "null"
}
],
"title": "Healthcheck"
},
"expose": {
"items": {},
"type": "array",
"title": "Expose"
},
"ports": {
"items": {},
"type": "array",
"title": "Ports"
},
"volumes": {
"items": {},
"type": "array",
"title": "Volumes"
},
"scale": {
"anyOf": [
{
"type": "integer",
"minimum": 0.0
},
{
"type": "null"
}
],
"title": "Scale"
}
},
"additionalProperties": true,
"type": "object",
"title": "SubmittedComposeService",
"description": "Pullable service in a normalized hosted Compose document."
},
"SubmittedRuntimeConfig": {
"properties": {
"image": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "null"
}
],
"title": "Image"
},
"compose": {
"anyOf": [
{
"$ref": "#/$defs/SubmittedComposeProject"
},
{
"type": "null"
}
]
},
"resources": {
"anyOf": [
{
"$ref": "#/$defs/SubmittedRuntimeResources"
},
{
"type": "null"
}
]
},
"limits": {
"anyOf": [
{
"$ref": "#/$defs/SubmittedRuntimeLimits"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false,
"type": "object",
"title": "SubmittedRuntimeConfig",
"description": "SDK ``RuntimeConfig`` accepted by hosted v6 submissions.\n\nProvider-specific support is validated by the SDK runtime implementation."
},
"SubmittedRuntimeGPU": {
"properties": {
"type": {
"anyOf": [
{
"type": "string",
"maxLength": 64,
"minLength": 1
},
{
"type": "null"
}
],
"title": "Type"
},
"count": {
"type": "integer",
"minimum": 1.0,
"title": "Count",
"default": 1
}
},
"additionalProperties": false,
"type": "object",
"title": "SubmittedRuntimeGPU",
"description": "Wire-compatible subset of ``hud.eval.runtime.RuntimeGPU``."
},
"SubmittedRuntimeLimits": {
"properties": {
"startup_timeout_s": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0.0
},
{
"type": "null"
}
],
"title": "Startup Timeout S"
},
"run_timeout_s": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0.0
},
{
"type": "null"
}
],
"title": "Run Timeout S"
}
},
"additionalProperties": false,
"type": "object",
"title": "SubmittedRuntimeLimits",
"description": "Wire-compatible subset of ``hud.eval.runtime.RuntimeLimits``."
},
"SubmittedRuntimeResources": {
"properties": {
"cpu": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0.0
},
{
"type": "null"
}
],
"title": "Cpu"
},
"memory_mb": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0.0
},
{
"type": "null"
}
],
"title": "Memory Mb"
},
"storage_mb": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0.0
},
{
"type": "null"
}
],
"title": "Storage Mb"
},
"gpu": {
"anyOf": [
{
"$ref": "#/$defs/SubmittedRuntimeGPU"
},
{
"type": "null"
}
]
},
"os": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "null"
}
],
"title": "Os"
}
},
"additionalProperties": false,
"type": "object",
"title": "SubmittedRuntimeResources",
"description": "Wire-compatible subset of ``hud.eval.runtime.RuntimeResources``.\n\nHosted runtimes run Linux, so ``os`` accepts only ``linux`` in any case."
}
}
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/hud-ai-rollout-run-request"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.