PublicAgentTaskList
The schema for what ``paginated`` builds. Kept beside it deliberately. A list operation whose ``responses`` named the *item* serializer with ``many=True`` published a bare array while the runtime returned this object, so a generated client broke on its first call. Subclasses add ``items``: each operation needs its own named component or the item type is erased.
Properties
| Name | Type | Description |
|---|---|---|
| total | integer | Rows matching the query, before `limit` and `offset`. |
| offset | integer | Rows skipped. Echoed back so a caller can page without bookkeeping. |
| limit | integer | Cap actually applied, which may be lower than the one requested. |
| note | string | How to narrow, when the cap hid rows. Empty when the response is the whole answer. |
| items | array |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/iterant-ai/json-schema/iterant-ai-public-agent-task-list-schema.json",
"title": "PublicAgentTaskList",
"description": "The schema for what ``paginated`` builds. Kept beside it deliberately.\n\nA list operation whose ``responses`` named the *item* serializer with\n``many=True`` published a bare array while the runtime returned this object,\nso a generated client broke on its first call. Subclasses add ``items``:\neach operation needs its own named component or the item type is erased.",
"x-generated": "2026-11-12",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/iterant-ai-openapi.json#/components/schemas/PublicAgentTaskList",
"type": "object",
"properties": {
"total": {
"type": "integer",
"description": "Rows matching the query, before `limit` and `offset`."
},
"offset": {
"type": "integer",
"description": "Rows skipped. Echoed back so a caller can page without bookkeeping."
},
"limit": {
"type": "integer",
"description": "Cap actually applied, which may be lower than the one requested."
},
"note": {
"type": "string",
"description": "How to narrow, when the cap hid rows. Empty when the response is the whole answer."
},
"items": {
"type": "array",
"items": {
"$ref": "#/$defs/PublicAgentTask"
}
}
},
"required": [
"items",
"limit",
"note",
"offset",
"total"
],
"$defs": {
"CommandEnum": {
"enum": [
"prompt",
"build_page"
],
"type": "string",
"description": "* `prompt` - Prompt\n* `build_page` - Build page"
},
"PublicAgentTask": {
"type": "object",
"properties": {
"taskId": {
"type": "string",
"format": "uuid"
},
"command": {
"$ref": "#/$defs/CommandEnum"
},
"status": {
"$ref": "#/$defs/StatusEnum"
},
"createdAt": {
"type": "string",
"format": "date-time"
},
"finishedAt": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "Null while the task is running."
},
"resultingRoute": {
"type": "string",
"description": "The route the build produced. Always empty for a \"prompt\" task: a free-form turn has no single route, so its result is the chat thread."
},
"chatUrl": {
"type": "string"
},
"error": {
"type": "string",
"description": "Present only when `status` is `failed`."
}
},
"required": [
"chatUrl",
"command",
"createdAt",
"finishedAt",
"resultingRoute",
"status",
"taskId"
]
},
"StatusEnum": {
"enum": [
"running",
"succeeded",
"failed"
],
"type": "string",
"description": "* `running` - Running\n* `succeeded` - Succeeded\n* `failed` - Failed"
}
}
}
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/iterant-ai-public-agent-task-list"
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.