RolloutSubmitRequest
One v6 rollout under the SDK's job/trace identity. The SDK's rollout atom mints ``trace_id``/``job_id`` and submits the task by reference — env name, task id (the ``@env.task`` name), bound args — plus the serialized agent spec. The platform materializes the task_version chain, schedules an instance, and runs the rollout co-located with the env; the SDK polls the trace to completion. ``slug`` is the taskset row key (``Task.external_id`` / portable ``Task.slug``). It is distinct from ``task`` (the ``@env.task`` id used for scenario lookup) and is only needed when a job's taskset has multiple versions sharing the same scenario+args.
Properties
| Name | Type | Description |
|---|---|---|
| trace_id | string | |
| job_id | string | |
| group_id | object | |
| env | string | |
| task | string | |
| slug | object | |
| args | object | |
| runtime_config | object | |
| verifier | object | |
| agent | object |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/hud-ai/json-schema/hud-ai-rollout-submit-request-schema.json",
"title": "RolloutSubmitRequest",
"description": "One v6 rollout under the SDK's job/trace identity.\n\nThe SDK's rollout atom mints ``trace_id``/``job_id`` and submits the task\nby reference — env name, task id (the ``@env.task`` name), bound args —\nplus the serialized agent spec. The platform materializes the\ntask_version chain, schedules an instance, and runs the rollout co-located\nwith the env; the SDK polls the trace to completion.\n\n``slug`` is the taskset row key (``Task.external_id`` / portable\n``Task.slug``). It is distinct from ``task`` (the ``@env.task`` id used for\nscenario lookup) and is only needed when a job's taskset has multiple\nversions sharing the same scenario+args.",
"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/RolloutSubmitRequest",
"properties": {
"trace_id": {
"type": "string",
"format": "uuid",
"title": "Trace Id"
},
"job_id": {
"type": "string",
"format": "uuid",
"title": "Job Id"
},
"group_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Group Id"
},
"env": {
"type": "string",
"minLength": 1,
"title": "Env"
},
"task": {
"type": "string",
"minLength": 1,
"title": "Task"
},
"slug": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "null"
}
],
"title": "Slug"
},
"args": {
"additionalProperties": true,
"type": "object",
"title": "Args",
"default": {}
},
"runtime_config": {
"anyOf": [
{
"$ref": "#/$defs/SubmittedRuntimeConfig"
},
{
"type": "null"
}
]
},
"verifier": {
"anyOf": [
{
"$ref": "#/$defs/SubmittedVerifierTask"
},
{
"type": "null"
}
]
},
"agent": {
"$ref": "#/$defs/SubmittedAgentSpec"
}
},
"type": "object",
"required": [
"trace_id",
"job_id",
"env",
"task",
"agent"
],
"$defs": {
"SubmittedAgentSpec": {
"properties": {
"type": {
"type": "string",
"enum": [
"claude",
"claude_cli",
"codex_cli",
"openai",
"gemini",
"openai_compatible"
],
"title": "Type"
},
"config": {
"additionalProperties": true,
"type": "object",
"title": "Config"
}
},
"type": "object",
"required": [
"type",
"config"
],
"title": "SubmittedAgentSpec",
"description": "Registered identity a hosted runner rebuilds the agent from.\n\nMirrors the v6 SDK's hosted submission: the ``AgentType`` value plus the\n``Agent.dump()`` config with runtime-only state and credentials stripped.\nThe control plane reads ``model`` (for inference routing and billing) and\n``max_steps`` from ``config``, and stores ``config`` as submitted except\nthat ``model`` becomes the catalog's canonical model name. The instance\nrebuilds the agent through ``AgentType``."
},
"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."
},
"SubmittedVerifierTask": {
"properties": {
"env": {
"type": "string",
"minLength": 1,
"title": "Env"
},
"id": {
"type": "string",
"minLength": 1,
"title": "Id"
},
"args": {
"additionalProperties": true,
"type": "object",
"title": "Args"
},
"slug": {
"type": "string",
"minLength": 1,
"title": "Slug"
},
"validation": {
"anyOf": [
{
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
{
"type": "null"
}
],
"title": "Validation"
},
"agent_config": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "Agent Config"
},
"columns": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "Columns"
},
"runtime_config": {
"anyOf": [
{
"$ref": "#/$defs/SubmittedRuntimeConfig"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false,
"type": "object",
"required": [
"env",
"id",
"slug"
],
"title": "SubmittedVerifierTask",
"description": "Nested verifier task carried by a task row."
}
}
}
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
curl "https://apis.io/api/v1/json-schemas/hud-ai-rollout-submit-request"
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.