Starts up to 1000 runs, each as POST /runs would. All are created or none is; an error names the request it is for. A batch may not name the same dedicated phone twice. The batch is refused with 409 while your organization is at its concurrency limit; its runs beyond the limit wait in the queue for a free slot.
{
"detail": "Property foo is required but is missing.",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}
{
"detail": "Property foo is required but is missing.",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}
{
"detail": "Property foo is required but is missing.",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}
{
"detail": "Property foo is required but is missing.",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}
{
"detail": "Property foo is required but is missing.",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}
{
"detail": "Property foo is required but is missing.",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}
{
"detail": "Property foo is required but is missing.",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}
{"docsConfig":{"theme":"maple","$schema":"https://mintlify.com/docs.json","name":"Axilio","colors":{"primary":"#10B981","light":"#34D399","dark":"#059669"},"logo":{"light":"https://mintcdn.com/axilio/MykQsDZmWO83uzQl/logo/axilio-light.svg?fit=max\u0026auto=format\u0026n=MykQsDZmWO83uzQl\u0026q=85\u0026s=dae3bccd996c953fc0d057e5e3ea864b","dark":"https://mintcdn.com/axilio/MykQsDZmWO83uzQl/logo/axilio-dark.svg?fit=max\u0026auto=format\u0026n=MykQsDZmWO83uzQl\u0026q=85\u0026s=6741fdd9c104cfb172c398e46e56f99e","href":"/"},"favicon":"https://mintcdn.com/axilio/-4W7dHye899AKtd2/favicon.png?fit=max\u0026auto=format\u0026n=-4W7dHye899AKtd2\u0026q=85\u0026s=ccbcf870ee071be390ccc3438ca92b85","appearance":{"default":"dark"},"background":{"color":{"light":"#FFFFFF","dark":"#0A0A0A"}},"navbar":{"primary":{"type":"button","label":"Sign up","href":"https://axilio.ai"}},"footer":{"socials":{"website":"https://axilio.ai"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"axilio","hasAudioNarration":false,"actualSubdomain":"axilio","customDomains":["docs.axilio.ai"],"gitSource":{"type":"github","owner":"axilioai","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"collectionId":"e0ac3842-bf8f-42e9-a108-c53a8f418c6c","liveDeploymentHistoryId":"6ae7dfa596fc0054bede9693","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae7dfa596fc0054bede9693"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae7dfa596fc0054bede9693","clientVersion":"0.0.4067","searchFilterCounts":[{"language":"default","tag":"API Reference","count":117},{"language":"default","tag":"REST API","count":102},{"language":"default","tag":"Platform","count":41},{"language":"default","tag":"Drivers","count":18},{"language":"default","tag":"Agents","count":18},{"language":"default","tag":"Phones","count":17},{"language":"default","tag":"Mobile driver","count":15},{"language":"default","tag":"Webhooks","count":15},{"language":"default","tag":"Billing","count":14},{"language":"default","tag":"Runs","count":14}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"*,*::before,*::after{border-radius:0!important}@media (min-width: 1024px){#content-area{max-width:46rem!important}}html.dark #content-area,html.dark #content-area p,html.dark #content-area li,html.dark #content-area td{color:#d4d4d4}html.dark #content-area h1,html.dark #content-area h2,html.dark #content-area h3,html.dark #content-area h4,html.dark #content-area h5,html.dark #content-area strong,html.dark #content-area th{color:#fafafa}html.dark #content-area h1+p,html.dark #content-area .lead{color:#a1a1a1}html.dark #content-area .code-block{border-color:rgba(255, 255, 255, 0.12)!important}html.dark #content-area .code-block>div{background-color:#16181c!important}html.dark #content-area .code-block [class~=\"print:hidden\"]{--fade-color-dark: #16181c !important}#content-area code a,#content-area a code{color:rgb(var(--primary))!important;text-decoration:underline;text-underline-offset:2px}html.dark #content-area .callout{background:rgba(255, 255, 255, 0.035)!important}html.dark #content-area .callout :is(p,li,span,strong,em){color:#d4d4d4!important}#content-area :is(p,ul,ol,table){margin-top:0;margin-bottom:0.9rem}#content-area [data-component-part=\"accordion-title\"]{margin:0!important}#credit-bucket-diagram-accordion-title::before{content:\"Diagram: \";font-weight:700}#content-area :is(li){margin-top:0.25rem;margin-bottom:0.25rem}#content-area h2{margin-top:2.5rem;margin-bottom:0.85rem}#content-area h3{margin-top:1.9rem;margin-bottom:0.5rem}#content-area h4{margin-top:1.5rem;margin-bottom:0.4rem}#content-area :is(.code-block,.code-group,.callout){margin-top:1.15rem!important;margin-bottom:1.15rem!important}#content-area :is(h1,h2,h3,h4)+:is(p,ul,ol,.code-block,.code-group,.callout){margin-top:0!important}#content-area .mdx-content{margin-top:1.5rem!important}#table-of-contents{overflow-x:hidden}#table-of-contents a,#table-of-contents code,#table-of-contents span{white-space:normal!important;overflow-wrap:anywhere;word-break:break-word}#sidebar-content{border-right:1px solid rgba(255, 255, 255, 0.08)}html.light #sidebar-content{border-right-color:rgba(0, 0, 0, 0.08)}.api-role{display:inline-block;font-size:0.75rem;font-weight:600;letter-spacing:0.01em;padding:0.12em 0.5em;border:1px solid rgba(255, 255, 255, 0.15);color:#a3a3a3;background:rgba(255, 255, 255, 0.04);vertical-align:middle}html.light .api-role{border-color:rgba(0, 0, 0, 0.15);color:#666;background:rgba(0, 0, 0, 0.03)}.axilio-copy-prompt-button{display:inline-flex;align-items:center;gap:0.55rem;min-height:2.5rem;padding:0.6rem 0.9rem;border:1px solid rgba(16, 185, 129, 0.45);color:#34d399;background:rgba(16, 185, 129, 0.08);font:700 0.78rem/1 ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;letter-spacing:0.06em;text-transform:uppercase;cursor:pointer;transition:border-color 160ms ease, color 160ms ease, background 160ms ease}.axilio-copy-prompt-button:hover:not(:disabled),.axilio-copy-prompt-button[data-state=\"copied\"]{border-color:#10b981;color:#ecfdf5;background:rgba(16, 185, 129, 0.16)}.axilio-copy-prompt-button:focus-visible{outline:2px solid #34d399;outline-offset:2px}.axilio-copy-prompt-button:disabled{cursor:default}.axilio-copy-prompt-button svg{width:1rem;height:1rem;fill:none;stroke:currentColor;stroke-width:1.8;stroke-linecap:round;stroke-linejoin:round}html.light .axilio-copy-prompt-button{border-color:rgba(5, 150, 105, 0.38);color:#047857;background:rgba(16, 185, 129, 0.08)}.axilio-rental-grid{display:grid;grid-template-columns:repeat(3, minmax(0, 1fr));gap:1px;margin:1.5rem 0;overflow:hidden;border:1px solid #262626;border-radius:0.75rem;background:#262626}.axilio-rental-card{position:relative;display:flex;min-width:0;flex-direction:column;padding:1.5rem;background:#0a0a0a}.axilio-rental-card.is-popular{box-shadow:inset 0 0 0 1px rgba(16, 185, 129, 0.8)}.axilio-rental-badge{position:absolute;top:0;right:0;padding:0.3rem 0.65rem;border-bottom-left-radius:0.5rem;background:#10b981;color:#02130d;font-size:0.65rem;font-weight:800;letter-spacing:0.08em;line-height:1;text-transform:uppercase}.axilio-rental-eyebrow,.axilio-rental-per-phone{color:#737373;font-size:0.68rem;font-weight:700;letter-spacing:0.1em;text-transform:uppercase}.axilio-rental-card h3{margin:0.55rem 0 1rem;color:#fafafa;font-size:1.15rem;letter-spacing:0.04em}.axilio-rental-price{display:flex;align-items:baseline;gap:0.25rem;color:#a3a3a3}.axilio-rental-price strong{color:#34d399;font-size:2rem;line-height:1}.axilio-rental-per-phone{margin:0.65rem 0 1.15rem;padding-bottom:1rem;border-bottom:1px solid #262626}.axilio-rental-card ul{display:grid;gap:0.75rem;margin:0;padding:0;list-style:none}.axilio-rental-card li{display:flex;gap:0.55rem;margin:0;color:#a3a3a3;font-size:0.82rem;line-height:1.4}.axilio-rental-card li::before{display:none!important;content:none!important}.axilio-rental-card li span{flex:none;color:#10b981;font-weight:800}html.light .axilio-rental-grid{border-color:#d4d4d4;background:#d4d4d4}html.light .axilio-rental-card{background:#ffffff}html.light .axilio-rental-card h3{color:#171717}html.light .axilio-rental-price,html.light .axilio-rental-card li{color:#525252}html.light .axilio-rental-price strong,html.light .axilio-rental-card li span{color:#047857}html.light .axilio-rental-per-phone{border-color:#e5e5e5}@media (max-width: 900px){.axilio-rental-grid{grid-template-columns:1fr}}.ax-interface-grid{display:grid;grid-template-columns:repeat(4, minmax(0, 1fr));gap:0.75rem;margin:1.1rem 0 1.5rem}.ax-interface-card{position:relative;min-width:0;aspect-ratio:1 / 1;border:1px solid rgba(255, 255, 255, 0.1);background:#0a0a0a;overflow:hidden;transition:border-color 160ms ease, background 160ms ease}.ax-interface-card:hover{border-color:#10b981;background:rgba(16, 185, 129, 0.035)}.ax-interface-card__main{position:relative;z-index:1;display:flex;width:100%;height:100%;min-height:0;flex-direction:column;padding:1.25rem;color:inherit!important;text-decoration:none!important}.ax-interface-card--with-repo .ax-interface-card__main{padding-right:1.25rem}.ax-interface-card__mark{display:inline-flex;flex:1 1 auto;width:100%;min-height:0;align-items:center;justify-content:center;color:#34d399;background:transparent;transition:color 160ms ease, transform 160ms ease}.ax-interface-card:hover .ax-interface-card__mark{color:#ecfdf5;background:transparent;transform:translateY(-2px)}.ax-interface-card__mark svg{width:6.25rem;height:6.25rem;overflow:visible}.ax-interface-card__mark>svg:not(.filled){fill:none;stroke:currentColor;stroke-width:2;stroke-linecap:round;stroke-linejoin:round}.ax-interface-card__prompt{font:700 3.25rem/1 ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;letter-spacing:-0.08em}.ax-interface-card__globe svg{width:6.25rem;height:6.25rem;stroke-width:4}.ax-globe-icon__rim{fill:rgba(16, 185, 129, 0.1)}.ax-interface-card__python svg{width:6.25rem;height:6.25rem;stroke:none!important;filter:drop-shadow(0 4px 8px rgba(5, 150, 105, 0.2))}.ax-python-top{fill:#10b981}.ax-python-bottom{fill:#6ee7b7}.ax-interface-card__go{width:100%}.ax-interface-card__go img{width:4.75rem;height:6.6rem;object-fit:contain;filter:drop-shadow(0 4px 8px rgba(5, 150, 105, 0.22));transition:filter 160ms ease, transform 160ms ease}.ax-interface-card:hover .ax-python-top{fill:#34d399}.ax-interface-card:hover .ax-python-bottom{fill:#d1fae5}.ax-interface-card:hover .ax-interface-card__go img{filter:drop-shadow(0 6px 10px rgba(16, 185, 129, 0.35));transform:translateY(-1px)}.ax-interface-card__copy{display:flex;min-width:0;flex-direction:column;align-items:center;flex:0 0 auto;text-align:center}.ax-interface-card__eyebrow{margin:0 0 0.45rem;color:#34d399;font-size:0.7rem;font-weight:700;letter-spacing:0.12em;line-height:1;text-transform:uppercase}.ax-interface-card__title{color:#fafafa;font-size:1.15rem;font-weight:700;line-height:1.25}.ax-interface-card__repo{position:absolute;z-index:3;bottom:1rem;left:1rem;display:inline-flex;width:2.25rem;height:2.25rem;align-items:center;justify-content:center;border:1px solid rgba(16, 185, 129, 0.4);color:#34d399!important;background:rgba(16, 185, 129, 0.08);pointer-events:auto;transition:border-color 160ms ease, color 160ms ease, background 160ms ease}.ax-interface-card__repo:hover{border-color:#10b981;color:#ecfdf5!important;background:rgba(16, 185, 129, 0.16)}.ax-interface-card__repo svg{width:1.05rem;height:1.05rem;fill:currentColor}.ax-interface-card :is(a:focus-visible){outline:2px solid #34d399;outline-offset:-3px}html.light .ax-interface-card{border-color:rgba(0, 0, 0, 0.12);background:#ffffff}html.light .ax-interface-card__title{color:#111827}html.light .ax-interface-card__repo{border-color:rgba(5, 150, 105, 0.38);color:#059669!important;background:rgba(16, 185, 129, 0.08)}@media (max-width: 1040px){.ax-interface-grid{grid-template-columns:repeat(2, minmax(0, 1fr))}}@media (max-width: 520px){.ax-interface-card__main{padding:1rem}.ax-interface-card--with-repo .ax-interface-card__main{padding-right:1rem}.ax-interface-card__mark{width:100%}.ax-interface-card__mark svg,.ax-interface-card__globe svg,.ax-interface-card__python svg{width:4rem;height:4rem}.ax-interface-card__prompt{font-size:2.4rem}.ax-interface-card__go img{width:3.25rem;height:4.5rem}.ax-interface-card__repo{bottom:0.75rem;left:0.75rem;width:2rem;height:2rem}}"}],"page":{"pagePath":"api-reference/rest/runs/start-several-runs","slug":"/api-reference/rest/runs/start-several-runs","pageMetadata":{"title":"Start several runs","description":"Starts up to 1000 runs, each as POST /runs would. All are created or none is; an error names the request it is for. A batch may not name the same dedicated phone twice. The batch is refused with 409 while your organization is at its concurrency limit; its runs beyond the limit wait in the queue for a free slot.","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json post /runs:batchCreate","href":"/api-reference/rest/runs/start-several-runs","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Starts up to 1000 runs, each as POST /runs would. All are created or none is; an error names the request it is for. A batch may not name the same dedicated phone twice. The batch is refused with 409 while your organization is at its concurrency limit; its runs beyond the limit wait in the queue for a free slot.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(`span`,{class:`api-role api-role-member`,title:`Members and admins can call this; viewers cannot.`,children:`Minimum role required: Member`})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Start several runs","description":"Starts up to 1000 runs, each as POST /runs would. All are created or none is; an error names the request it is for. A batch may not name the same dedicated phone twice. The batch is refused with 409 while your organization is at its concurrency limit; its runs beyond the limit wait in the queue for a free slot.","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json post /runs:batchCreate","href":"/api-reference/rest/runs/start-several-runs","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/axilio/cd806ad9a041499b/pricing-tables.js","/_mintlify/custom/axilio/ad188ddce7937743/surface-accent.js","/_mintlify/custom/axilio/a38aa6b3909d4cb6/copy-agent-prompt.js","/_mintlify/custom/axilio/abd909f84cec81bb/sdk-quickstart-tabs.js"],"openApiReferenceData":{"operation":{"description":"Starts up to 1000 runs, each as POST /runs would. All are created or none is; an error names the request it is for. A batch may not name the same dedicated phone twice. The batch is refused with 409 while your organization is at its concurrency limit; its runs beyond the limit wait in the queue for a free slot.","operationId":"runs_batch_create","requestBody":"c83e6238-5d3c-40ee-9b6f-176b9951a2c0","responses":{"201":"069404a9-f01a-415f-a7ef-ae1e4658a08f","400":"bbe1b34f-6349-4a56-9467-0ae6eb3a9720","402":"c3f08119-e6d7-468c-a202-29811bef001d","403":"fedbb03d-53a0-4bd4-b4a0-79c043691c77","404":"4424b0c3-581f-46cf-980d-5dd0162b9805","409":"e2c0525d-126c-484d-9c9a-cb51c0ce310a","422":"295fe0d8-8709-4141-a66e-f381adc05fa6","500":"7a13c394-9b41-4948-821e-86c35966a385"},"security":["de39f868-e9c3-4fdf-8029-0914205c9e71"],"summary":"Start several runs","tags":["Runs"],"x-required-role":"member","x-mint":{"content":"\u003cspan class=\"api-role api-role-member\" title=\"Members and admins can call this; viewers cannot.\">Minimum role required: Member\u003c/span>"},"method":"post","type":"path","servers":["374c87fc-e103-4302-b35a-9e65a062ab81"],"path":"/runs:batchCreate","baseUrlOptions":["https://api.axilio.ai/api/v1"],"title":"Start several runs","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"Start up to 1000 runs at once. All are created or none is.","properties":{"requests":{"oneOf":[{"description":"The runs to start.","items":{"additionalProperties":false,"description":"Start a run: of a saved agent (agent_id) or ad hoc (task), not both.","properties":{"agent_id":{"description":"The agent to run, with its current revision and settings.","format":"uuid","type":"string","uniqueKey":"requests.oneOf.0.items.[INDEX].agent_id","typeLabel":"string\u003cuuid>"},"keep_alive_seconds":{"description":"How long an agent-mode run holds its phone after a turn ends, so a message in that time continues it on the same phone (default 120 on POST /runs, 0 in a batch). 0 releases the phone at once.","format":"int64","maximum":3600,"minimum":0,"type":"integer","uniqueKey":"requests.oneOf.0.items.[INDEX].keep_alive_seconds","typeLabel":"integer\u003cint64>"},"max_cost_microdollars":{"description":"Most an ad hoc run's model steps may cost, in microdollars (default 10000000).","format":"int64","minimum":1,"type":"integer","uniqueKey":"requests.oneOf.0.items.[INDEX].max_cost_microdollars","typeLabel":"integer\u003cint64>"},"max_steps":{"description":"Most model steps an ad hoc run may take (default 500).","format":"int64","maximum":500,"minimum":1,"type":"integer","uniqueKey":"requests.oneOf.0.items.[INDEX].max_steps","typeLabel":"integer\u003cint64>"},"model":{"description":"An ad hoc run's model, one of GET /models (default the platform default). A saved agent's run uses the agent's.","type":"string","uniqueKey":"requests.oneOf.0.items.[INDEX].model","typeLabel":"string"},"network":{"description":"The network an instructions run's code can reach: restricted (default) reaches the phone only; internet adds the public internet. Code runs always have internet.","enum":["restricted","internet"],"type":"string","uniqueKey":"requests.oneOf.0.items.[INDEX].network","typeLabel":"enum\u003cstring>"},"output_schema":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"requests.oneOf.0.items.[INDEX].output_schema.additionalProperties","typeLabel":"any"},"description":"The JSON Schema an ad hoc run's result must satisfy. A saved agent's run uses the agent's.","type":"object","uniqueKey":"requests.oneOf.0.items.[INDEX].output_schema","typeLabel":"object"},"pause_timeout_seconds":{"description":"Longest an ad hoc run waits paused for an answer, in seconds (default 600).","format":"int64","maximum":3600,"minimum":60,"type":"integer","uniqueKey":"requests.oneOf.0.items.[INDEX].pause_timeout_seconds","typeLabel":"integer\u003cint64>"},"recording_enabled":{"description":"Record the screen of an ad hoc run (default false). A saved agent's run uses the agent's.","type":"boolean","uniqueKey":"requests.oneOf.0.items.[INDEX].recording_enabled","typeLabel":"boolean"},"start_at":{"description":"Start the run at this time, from a minute to 30 days ahead. Leave out to start now.","format":"date-time","type":"string","uniqueKey":"requests.oneOf.0.items.[INDEX].start_at","typeLabel":"string\u003cdate-time>"},"start_timeout_seconds":{"description":"How long the run may wait for a phone before it is cancelled (default 300).","format":"int64","maximum":86400,"minimum":60,"type":"integer","uniqueKey":"requests.oneOf.0.items.[INDEX].start_timeout_seconds","typeLabel":"integer\u003cint64>"},"targets":{"oneOf":[{"description":"The device the run drives (at most one). Leave out for a shared phone.","items":{"additionalProperties":false,"description":"The device a run drives. Phones only for now, Android only.","properties":{"device_class":{"description":"The kind of device.","enum":["phone"],"type":"string","isRequired":true,"uniqueKey":"requests.oneOf.0.items.[INDEX].targets.oneOf.0.items.[INDEX].device_class","typeLabel":"enum\u003cstring>"},"capabilities":{"additionalProperties":false,"description":"What the run needs of the phone.","properties":{"accessibility":{"description":"Run in accessibility mode, which needs a phone that supports it and your organization's access to accessibility mode.","type":"boolean","uniqueKey":"requests.oneOf.0.items.[INDEX].targets.oneOf.0.items.[INDEX].capabilities.accessibility","typeLabel":"boolean"}},"type":"object","uniqueKey":"requests.oneOf.0.items.[INDEX].targets.oneOf.0.items.[INDEX].capabilities","typeLabel":"object"},"ownership":{"description":"dedicated: one of your organization's phones, the one phone_id names or any free one. shared: a phone from the shared fleet. Defaults to dedicated when phone_id is set, else shared.","enum":["dedicated","shared"],"type":"string","uniqueKey":"requests.oneOf.0.items.[INDEX].targets.oneOf.0.items.[INDEX].ownership","typeLabel":"enum\u003cstring>"},"phone_id":{"description":"A dedicated phone of your organization to run on. Leave out for any of yours (ownership dedicated) or a shared phone.","type":"string","uniqueKey":"requests.oneOf.0.items.[INDEX].targets.oneOf.0.items.[INDEX].phone_id","typeLabel":"string"},"platform":{"description":"The device's platform (default android).","enum":["android"],"type":"string","uniqueKey":"requests.oneOf.0.items.[INDEX].targets.oneOf.0.items.[INDEX].platform","typeLabel":"enum\u003cstring>"}},"required":["device_class"],"type":"object","uniqueKey":"requests.oneOf.0.items.[INDEX].targets.oneOf.0.items.[INDEX]","typeLabel":"object"},"maxItems":1,"type":"array","uniqueKey":"requests.oneOf.0.items.[INDEX].targets.oneOf.0","typeLabel":"object[]"},{"description":"The device the run drives (at most one). Leave out for a shared phone.","items":{"additionalProperties":false,"description":"The device a run drives. Phones only for now, Android only.","properties":{"capabilities":{"additionalProperties":false,"description":"What the run needs of the phone.","properties":{"accessibility":{"description":"Run in accessibility mode, which needs a phone that supports it and your organization's access to accessibility mode.","type":"boolean"}},"type":"object"},"device_class":{"description":"The kind of device.","enum":["phone"],"type":"string"},"ownership":{"description":"dedicated: one of your organization's phones, the one phone_id names or any free one. shared: a phone from the shared fleet. Defaults to dedicated when phone_id is set, else shared.","enum":["dedicated","shared"],"type":"string"},"phone_id":{"description":"A dedicated phone of your organization to run on. Leave out for any of yours (ownership dedicated) or a shared phone.","type":"string"},"platform":{"description":"The device's platform (default android).","enum":["android"],"type":"string"}},"required":["device_class"],"type":"object"},"maxItems":1,"type":"null","uniqueKey":"requests.oneOf.0.items.[INDEX].targets.oneOf.1","typeLabel":"null"}],"uniqueKey":"requests.oneOf.0.items.[INDEX].targets","typeLabel":"object[] | null"},"task":{"description":"An ad hoc task for an agent to work through a model, with nothing saved.","maxLength":20000,"type":"string","uniqueKey":"requests.oneOf.0.items.[INDEX].task","typeLabel":"string"},"telemetry_enabled":{"description":"Emit telemetry for an ad hoc run (default true). A saved agent's run uses the agent's.","type":"boolean","uniqueKey":"requests.oneOf.0.items.[INDEX].telemetry_enabled","typeLabel":"boolean"},"timeout_seconds":{"description":"Longest an ad hoc run may take, in seconds (default 3600).","format":"int64","maximum":3600,"minimum":1,"type":"integer","uniqueKey":"requests.oneOf.0.items.[INDEX].timeout_seconds","typeLabel":"integer\u003cint64>"},"variables":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"requests.oneOf.0.items.[INDEX].variables.additionalProperties","typeLabel":"any"},"description":"The run's inputs, available to the run's code as the variables dict.","type":"object","uniqueKey":"requests.oneOf.0.items.[INDEX].variables","typeLabel":"object"}},"type":"object","uniqueKey":"requests.oneOf.0.items.[INDEX]","typeLabel":"object"},"maxItems":1000,"minItems":1,"type":"array","isRequired":true,"uniqueKey":"requests.oneOf.0","typeLabel":"object[]"},{"description":"The runs to start.","items":{"additionalProperties":false,"description":"Start a run: of a saved agent (agent_id) or ad hoc (task), not both.","properties":{"agent_id":{"description":"The agent to run, with its current revision and settings.","format":"uuid","type":"string"},"keep_alive_seconds":{"description":"How long an agent-mode run holds its phone after a turn ends, so a message in that time continues it on the same phone (default 120 on POST /runs, 0 in a batch). 0 releases the phone at once.","format":"int64","maximum":3600,"minimum":0,"type":"integer"},"max_cost_microdollars":{"description":"Most an ad hoc run's model steps may cost, in microdollars (default 10000000).","format":"int64","minimum":1,"type":"integer"},"max_steps":{"description":"Most model steps an ad hoc run may take (default 500).","format":"int64","maximum":500,"minimum":1,"type":"integer"},"model":{"description":"An ad hoc run's model, one of GET /models (default the platform default). A saved agent's run uses the agent's.","type":"string"},"network":{"description":"The network an instructions run's code can reach: restricted (default) reaches the phone only; internet adds the public internet. Code runs always have internet.","enum":["restricted","internet"],"type":"string"},"output_schema":{"additionalProperties":{"oneOf":[{}]},"description":"The JSON Schema an ad hoc run's result must satisfy. A saved agent's run uses the agent's.","type":"object"},"pause_timeout_seconds":{"description":"Longest an ad hoc run waits paused for an answer, in seconds (default 600).","format":"int64","maximum":3600,"minimum":60,"type":"integer"},"recording_enabled":{"description":"Record the screen of an ad hoc run (default false). A saved agent's run uses the agent's.","type":"boolean"},"start_at":{"description":"Start the run at this time, from a minute to 30 days ahead. Leave out to start now.","format":"date-time","type":"string"},"start_timeout_seconds":{"description":"How long the run may wait for a phone before it is cancelled (default 300).","format":"int64","maximum":86400,"minimum":60,"type":"integer"},"targets":{"oneOf":[{"description":"The device the run drives (at most one). Leave out for a shared phone.","items":{"additionalProperties":false,"description":"The device a run drives. Phones only for now, Android only.","properties":{"capabilities":{"additionalProperties":false,"description":"What the run needs of the phone.","properties":{"accessibility":{"description":"Run in accessibility mode, which needs a phone that supports it and your organization's access to accessibility mode.","type":"boolean"}},"type":"object"},"device_class":{"description":"The kind of device.","enum":["phone"],"type":"string"},"ownership":{"description":"dedicated: one of your organization's phones, the one phone_id names or any free one. shared: a phone from the shared fleet. Defaults to dedicated when phone_id is set, else shared.","enum":["dedicated","shared"],"type":"string"},"phone_id":{"description":"A dedicated phone of your organization to run on. Leave out for any of yours (ownership dedicated) or a shared phone.","type":"string"},"platform":{"description":"The device's platform (default android).","enum":["android"],"type":"string"}},"required":["device_class"],"type":"object"},"maxItems":1,"type":"array"},{"description":"The device the run drives (at most one). Leave out for a shared phone.","items":{"additionalProperties":false,"description":"The device a run drives. Phones only for now, Android only.","properties":{"capabilities":{"additionalProperties":false,"description":"What the run needs of the phone.","properties":{"accessibility":{"description":"Run in accessibility mode, which needs a phone that supports it and your organization's access to accessibility mode.","type":"boolean"}},"type":"object"},"device_class":{"description":"The kind of device.","enum":["phone"],"type":"string"},"ownership":{"description":"dedicated: one of your organization's phones, the one phone_id names or any free one. shared: a phone from the shared fleet. Defaults to dedicated when phone_id is set, else shared.","enum":["dedicated","shared"],"type":"string"},"phone_id":{"description":"A dedicated phone of your organization to run on. Leave out for any of yours (ownership dedicated) or a shared phone.","type":"string"},"platform":{"description":"The device's platform (default android).","enum":["android"],"type":"string"}},"required":["device_class"],"type":"object"},"maxItems":1,"type":"null"}]},"task":{"description":"An ad hoc task for an agent to work through a model, with nothing saved.","maxLength":20000,"type":"string"},"telemetry_enabled":{"description":"Emit telemetry for an ad hoc run (default true). A saved agent's run uses the agent's.","type":"boolean"},"timeout_seconds":{"description":"Longest an ad hoc run may take, in seconds (default 3600).","format":"int64","maximum":3600,"minimum":1,"type":"integer"},"variables":{"additionalProperties":{"oneOf":[{}]},"description":"The run's inputs, available to the run's code as the variables dict.","type":"object"}},"type":"object"},"maxItems":1000,"minItems":1,"type":"null","isRequired":true,"uniqueKey":"requests.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"requests","typeLabel":"object[] | null"}},"required":["requests"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"requests":[{"agent_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","keep_alive_seconds":1800,"max_cost_microdollars":2,"max_steps":250,"model":"\u003cstring>","output_schema":{},"pause_timeout_seconds":1830,"recording_enabled":true,"start_at":"2023-11-07T05:31:56Z","start_timeout_seconds":43230,"targets":[{"device_class":"phone","capabilities":{"accessibility":true},"phone_id":"\u003cstring>","platform":"android"}],"task":"\u003cstring>","telemetry_enabled":true,"timeout_seconds":1800,"variables":{}}]}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"069404a9-f01a-415f-a7ef-ae1e4658a08f":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"The runs a batch started, in request order.","properties":{"runs":{"oneOf":[{"description":"The runs, in request order.","items":{"additionalProperties":false,"description":"A run: of a saved agent, or of an ad hoc task.","properties":{"created_at":{"description":"Timestamp when the run record was created.","format":"date-time","type":"string","isRequired":true,"uniqueKey":"runs.oneOf.0.items.[INDEX].created_at","typeLabel":"string\u003cdate-time>"},"id":{"description":"Run identifier.","format":"uuid","type":"string","isRequired":true,"uniqueKey":"runs.oneOf.0.items.[INDEX].id","typeLabel":"string\u003cuuid>"},"mode":{"description":"agent: an agent works the task through a model. code: the agent's script runs.","enum":["agent","code"],"type":"string","isRequired":true,"uniqueKey":"runs.oneOf.0.items.[INDEX].mode","typeLabel":"enum\u003cstring>"},"status":{"description":"Current lifecycle state of the run. paused: the run waits on a person; see input_request.","enum":["scheduled","queued","running","paused","completed","failed","cancelled"],"type":"string","isRequired":true,"uniqueKey":"runs.oneOf.0.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"trigger":{"description":"Trigger identifies how the run was initiated.","enum":["manual","scheduled","api"],"type":"string","isRequired":true,"uniqueKey":"runs.oneOf.0.items.[INDEX].trigger","typeLabel":"enum\u003cstring>"},"updated_at":{"description":"Timestamp of the last update to the run record.","format":"date-time","type":"string","isRequired":true,"uniqueKey":"runs.oneOf.0.items.[INDEX].updated_at","typeLabel":"string\u003cdate-time>"},"user_id":{"description":"User who initiated the run.","format":"uuid","type":"string","isRequired":true,"uniqueKey":"runs.oneOf.0.items.[INDEX].user_id","typeLabel":"string\u003cuuid>"},"agent_id":{"description":"The agent the run is of; absent on an ad hoc run.","format":"uuid","type":"string","uniqueKey":"runs.oneOf.0.items.[INDEX].agent_id","typeLabel":"string\u003cuuid>"},"agent_name":{"description":"The agent's name, on the run lists; absent on an ad hoc run.","type":"string","uniqueKey":"runs.oneOf.0.items.[INDEX].agent_name","typeLabel":"string"},"cancelled_at":{"description":"Timestamp when the run was cancelled.","format":"date-time","type":"string","uniqueKey":"runs.oneOf.0.items.[INDEX].cancelled_at","typeLabel":"string\u003cdate-time>"},"completed_at":{"description":"Timestamp when the run finished.","format":"date-time","type":"string","uniqueKey":"runs.oneOf.0.items.[INDEX].completed_at","typeLabel":"string\u003cdate-time>"},"error":{"description":"Why the run failed.","type":"string","uniqueKey":"runs.oneOf.0.items.[INDEX].error","typeLabel":"string"},"input_request":{"additionalProperties":false,"description":"What a paused run asks a person; answer it with :resume.","properties":{"created_at":{"description":"When the run paused.","format":"date-time","type":"string","isRequired":true,"uniqueKey":"runs.oneOf.0.items.[INDEX].input_request.created_at","typeLabel":"string\u003cdate-time>"},"expires_at":{"description":"When the run stops waiting and fails with input_timeout: the earliest of its pause timeout, its time limit and the end of its session.","format":"date-time","type":"string","isRequired":true,"uniqueKey":"runs.oneOf.0.items.[INDEX].input_request.expires_at","typeLabel":"string\u003cdate-time>"},"id":{"description":"The input request's id, which a resume names.","format":"uuid","type":"string","isRequired":true,"uniqueKey":"runs.oneOf.0.items.[INDEX].input_request.id","typeLabel":"string\u003cuuid>"},"reason":{"description":"Why the run paused.","enum":["one_time_code_required","approval_required","choice_required","challenge_blocked","step_check_failed","caller_requested"],"type":"string","isRequired":true,"uniqueKey":"runs.oneOf.0.items.[INDEX].input_request.reason","typeLabel":"enum\u003cstring>"},"requested_by":{"description":"agent: the agent asked. code: the script asked, or failed with on_failure ask. caller: the run was paused through the API.","enum":["agent","code","caller"],"type":"string","isRequired":true,"uniqueKey":"runs.oneOf.0.items.[INDEX].input_request.requested_by","typeLabel":"enum\u003cstring>"},"message":{"description":"The question, for the person answering.","type":"string","uniqueKey":"runs.oneOf.0.items.[INDEX].input_request.message","typeLabel":"string"},"response_schema":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"runs.oneOf.0.items.[INDEX].input_request.response_schema.additionalProperties","typeLabel":"any"},"description":"The JSON Schema the answer must satisfy. Absent takes any answer.","type":"object","uniqueKey":"runs.oneOf.0.items.[INDEX].input_request.response_schema","typeLabel":"object"}},"required":["id","requested_by","reason","created_at","expires_at"],"type":"object","uniqueKey":"runs.oneOf.0.items.[INDEX].input_request","typeLabel":"object"},"keep_alive_expires_at":{"description":"Until when an ended agent-mode run holds its phone: :sendMessage before then continues the run there; after it, start a new run.","format":"date-time","type":"string","uniqueKey":"runs.oneOf.0.items.[INDEX].keep_alive_expires_at","typeLabel":"string\u003cdate-time>"},"max_cost_microdollars":{"description":"Most the run's model steps may cost, in microdollars.","format":"int64","type":"integer","uniqueKey":"runs.oneOf.0.items.[INDEX].max_cost_microdollars","typeLabel":"integer\u003cint64>"},"max_steps":{"description":"Most model steps the run may take.","format":"int64","type":"integer","uniqueKey":"runs.oneOf.0.items.[INDEX].max_steps","typeLabel":"integer\u003cint64>"},"model":{"description":"The model the run's steps call, one of GET /models.","type":"string","uniqueKey":"runs.oneOf.0.items.[INDEX].model","typeLabel":"string"},"network":{"description":"The network the run's code can reach: restricted reaches the phone only; internet adds the public internet.","enum":["restricted","internet"],"type":"string","uniqueKey":"runs.oneOf.0.items.[INDEX].network","typeLabel":"enum\u003cstring>"},"output":{"description":"The run's result, which satisfies its output_schema.","uniqueKey":"runs.oneOf.0.items.[INDEX].output","typeLabel":"any"},"output_schema":{"description":"The JSON Schema the run's result must satisfy.","uniqueKey":"runs.oneOf.0.items.[INDEX].output_schema","typeLabel":"any"},"pause_timeout_seconds":{"description":"Longest the run waits paused for an answer, in seconds.","format":"int64","type":"integer","uniqueKey":"runs.oneOf.0.items.[INDEX].pause_timeout_seconds","typeLabel":"integer\u003cint64>"},"phone_id":{"description":"Phone executing the run.","type":"string","uniqueKey":"runs.oneOf.0.items.[INDEX].phone_id","typeLabel":"string"},"recording_enabled":{"description":"An ad hoc run's own recording choice; absent takes the default (off), and a saved agent's run takes the agent's.","type":"boolean","uniqueKey":"runs.oneOf.0.items.[INDEX].recording_enabled","typeLabel":"boolean"},"repair":{"additionalProperties":false,"description":"On a code run: whether the agent took over after the script failed, and the fix it proposed.","properties":{"repaired":{"description":"The script failed and the agent took over.","type":"boolean","isRequired":true,"uniqueKey":"runs.oneOf.0.items.[INDEX].repair.repaired","typeLabel":"boolean"},"proposed_revision_id":{"description":"The fixed revision the repair proposed, waiting to be promoted. Absent when a fix for the revision was already waiting.","format":"uuid","type":"string","uniqueKey":"runs.oneOf.0.items.[INDEX].repair.proposed_revision_id","typeLabel":"string\u003cuuid>"}},"required":["repaired"],"type":"object","uniqueKey":"runs.oneOf.0.items.[INDEX].repair","typeLabel":"object"},"result_text":{"description":"A short account of the run's result.","type":"string","uniqueKey":"runs.oneOf.0.items.[INDEX].result_text","typeLabel":"string"},"revision_id":{"description":"The agent's revision the run was pinned to when it was made.","format":"uuid","type":"string","uniqueKey":"runs.oneOf.0.items.[INDEX].revision_id","typeLabel":"string\u003cuuid>"},"run_metadata":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"runs.oneOf.0.items.[INDEX].run_metadata.additionalProperties","typeLabel":"any"},"description":"Arbitrary metadata attached to the run.","type":"object","uniqueKey":"runs.oneOf.0.items.[INDEX].run_metadata","typeLabel":"object"},"schedule_id":{"description":"The schedule that started the run, if one did.","format":"uuid","type":"string","uniqueKey":"runs.oneOf.0.items.[INDEX].schedule_id","typeLabel":"string\u003cuuid>"},"session_id":{"description":"Session associated with this run.","format":"uuid","type":"string","uniqueKey":"runs.oneOf.0.items.[INDEX].session_id","typeLabel":"string\u003cuuid>"},"start_at":{"description":"When the run was booked to start; absent for a run started on request.","format":"date-time","type":"string","uniqueKey":"runs.oneOf.0.items.[INDEX].start_at","typeLabel":"string\u003cdate-time>"},"start_timeout_seconds":{"description":"How long the queued run may wait for a phone before auto-cancel.","format":"int64","type":"integer","uniqueKey":"runs.oneOf.0.items.[INDEX].start_timeout_seconds","typeLabel":"integer\u003cint64>"},"started_at":{"description":"Timestamp when the run began executing.","format":"date-time","type":"string","uniqueKey":"runs.oneOf.0.items.[INDEX].started_at","typeLabel":"string\u003cdate-time>"},"stream_url":{"description":"The run's live event stream (Server-Sent Events), with a short-lived read-only token. Server clients can send the API key header instead.","type":"string","uniqueKey":"runs.oneOf.0.items.[INDEX].stream_url","typeLabel":"string"},"success":{"description":"Whether the run completed without error.","type":"boolean","uniqueKey":"runs.oneOf.0.items.[INDEX].success","typeLabel":"boolean"},"targets":{"oneOf":[{"description":"The device the run drives.","items":{"additionalProperties":false,"description":"The device a run drives. Phones only for now, Android only.","properties":{"device_class":{"description":"The kind of device.","enum":["phone"],"type":"string","isRequired":true,"uniqueKey":"runs.oneOf.0.items.[INDEX].targets.oneOf.0.items.[INDEX].device_class","typeLabel":"enum\u003cstring>"},"capabilities":{"additionalProperties":false,"description":"What the run needs of the phone.","properties":{"accessibility":{"description":"Run in accessibility mode, which needs a phone that supports it and your organization's access to accessibility mode.","type":"boolean","uniqueKey":"runs.oneOf.0.items.[INDEX].targets.oneOf.0.items.[INDEX].capabilities.accessibility","typeLabel":"boolean"}},"type":"object","uniqueKey":"runs.oneOf.0.items.[INDEX].targets.oneOf.0.items.[INDEX].capabilities","typeLabel":"object"},"ownership":{"description":"dedicated: one of your organization's phones, the one phone_id names or any free one. shared: a phone from the shared fleet. Defaults to dedicated when phone_id is set, else shared.","enum":["dedicated","shared"],"type":"string","uniqueKey":"runs.oneOf.0.items.[INDEX].targets.oneOf.0.items.[INDEX].ownership","typeLabel":"enum\u003cstring>"},"phone_id":{"description":"A dedicated phone of your organization to run on. Leave out for any of yours (ownership dedicated) or a shared phone.","type":"string","uniqueKey":"runs.oneOf.0.items.[INDEX].targets.oneOf.0.items.[INDEX].phone_id","typeLabel":"string"},"platform":{"description":"The device's platform (default android).","enum":["android"],"type":"string","uniqueKey":"runs.oneOf.0.items.[INDEX].targets.oneOf.0.items.[INDEX].platform","typeLabel":"enum\u003cstring>"}},"required":["device_class"],"type":"object","uniqueKey":"runs.oneOf.0.items.[INDEX].targets.oneOf.0.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"runs.oneOf.0.items.[INDEX].targets.oneOf.0","typeLabel":"object[]"},{"description":"The device the run drives.","items":{"additionalProperties":false,"description":"The device a run drives. Phones only for now, Android only.","properties":{"capabilities":{"additionalProperties":false,"description":"What the run needs of the phone.","properties":{"accessibility":{"description":"Run in accessibility mode, which needs a phone that supports it and your organization's access to accessibility mode.","type":"boolean"}},"type":"object"},"device_class":{"description":"The kind of device.","enum":["phone"],"type":"string"},"ownership":{"description":"dedicated: one of your organization's phones, the one phone_id names or any free one. shared: a phone from the shared fleet. Defaults to dedicated when phone_id is set, else shared.","enum":["dedicated","shared"],"type":"string"},"phone_id":{"description":"A dedicated phone of your organization to run on. Leave out for any of yours (ownership dedicated) or a shared phone.","type":"string"},"platform":{"description":"The device's platform (default android).","enum":["android"],"type":"string"}},"required":["device_class"],"type":"object"},"type":"null","uniqueKey":"runs.oneOf.0.items.[INDEX].targets.oneOf.1","typeLabel":"null"}],"uniqueKey":"runs.oneOf.0.items.[INDEX].targets","typeLabel":"object[] | null"},"task":{"description":"An agent-mode run's task: the ad hoc task, or the agent's instructions.","type":"string","uniqueKey":"runs.oneOf.0.items.[INDEX].task","typeLabel":"string"},"telemetry_enabled":{"description":"An ad hoc run's own telemetry choice; absent takes the default (on), and a saved agent's run takes the agent's.","type":"boolean","uniqueKey":"runs.oneOf.0.items.[INDEX].telemetry_enabled","typeLabel":"boolean"},"timeout_seconds":{"description":"Longest the run may take, in seconds.","format":"int64","type":"integer","uniqueKey":"runs.oneOf.0.items.[INDEX].timeout_seconds","typeLabel":"integer\u003cint64>"},"trace_expired_at":{"description":"When the trace recording was deleted.","format":"date-time","type":"string","uniqueKey":"runs.oneOf.0.items.[INDEX].trace_expired_at","typeLabel":"string\u003cdate-time>"},"turn":{"description":"An agent-mode run's current turn, from 1.","format":"int64","type":"integer","uniqueKey":"runs.oneOf.0.items.[INDEX].turn","typeLabel":"integer\u003cint64>"},"turns":{"oneOf":[{"description":"Every turn of an agent-mode run, oldest first: the task, then each follow-up sent with :sendMessage.","items":{"additionalProperties":false,"description":"One turn of an agent-mode run: what opened it, how it ended, and what it used.","properties":{"status":{"description":"The turn's status.","enum":["queued","running","paused","completed","failed","cancelled"],"type":"string","isRequired":true,"uniqueKey":"runs.oneOf.0.items.[INDEX].turns.oneOf.0.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"turn":{"description":"The turn's number, from 1.","format":"int64","type":"integer","isRequired":true,"uniqueKey":"runs.oneOf.0.items.[INDEX].turns.oneOf.0.items.[INDEX].turn","typeLabel":"integer\u003cint64>"},"completed_at":{"description":"When the turn ended.","format":"date-time","type":"string","uniqueKey":"runs.oneOf.0.items.[INDEX].turns.oneOf.0.items.[INDEX].completed_at","typeLabel":"string\u003cdate-time>"},"error":{"description":"Why the turn failed.","type":"string","uniqueKey":"runs.oneOf.0.items.[INDEX].turns.oneOf.0.items.[INDEX].error","typeLabel":"string"},"message":{"description":"The message that opened the turn. Absent on turn 1, which works through the run's task.","type":"string","uniqueKey":"runs.oneOf.0.items.[INDEX].turns.oneOf.0.items.[INDEX].message","typeLabel":"string"},"model":{"description":"The model the turn's steps called.","type":"string","uniqueKey":"runs.oneOf.0.items.[INDEX].turns.oneOf.0.items.[INDEX].model","typeLabel":"string"},"output":{"description":"The turn's result, matching the run's output_schema.","uniqueKey":"runs.oneOf.0.items.[INDEX].turns.oneOf.0.items.[INDEX].output","typeLabel":"any"},"result_text":{"description":"The turn's result in a sentence.","type":"string","uniqueKey":"runs.oneOf.0.items.[INDEX].turns.oneOf.0.items.[INDEX].result_text","typeLabel":"string"},"session_id":{"description":"The phone session the turn ran in.","type":"string","uniqueKey":"runs.oneOf.0.items.[INDEX].turns.oneOf.0.items.[INDEX].session_id","typeLabel":"string"},"started_at":{"description":"When the turn started.","format":"date-time","type":"string","uniqueKey":"runs.oneOf.0.items.[INDEX].turns.oneOf.0.items.[INDEX].started_at","typeLabel":"string\u003cdate-time>"},"usage":{"additionalProperties":false,"description":"What the turn's model steps used.","properties":{"completion_tokens":{"description":"Completion tokens across those steps.","format":"int64","type":"integer","isRequired":true,"uniqueKey":"runs.oneOf.0.items.[INDEX].turns.oneOf.0.items.[INDEX].usage.completion_tokens","typeLabel":"integer\u003cint64>"},"cost_microdollars":{"description":"What those steps cost, in microdollars.","format":"int64","type":"integer","isRequired":true,"uniqueKey":"runs.oneOf.0.items.[INDEX].turns.oneOf.0.items.[INDEX].usage.cost_microdollars","typeLabel":"integer\u003cint64>"},"model_steps":{"description":"Model steps that got an answer.","format":"int64","type":"integer","isRequired":true,"uniqueKey":"runs.oneOf.0.items.[INDEX].turns.oneOf.0.items.[INDEX].usage.model_steps","typeLabel":"integer\u003cint64>"},"prompt_tokens":{"description":"Prompt tokens across those steps.","format":"int64","type":"integer","isRequired":true,"uniqueKey":"runs.oneOf.0.items.[INDEX].turns.oneOf.0.items.[INDEX].usage.prompt_tokens","typeLabel":"integer\u003cint64>"},"last_step":{"description":"The number of the turn's last step, answered or not: GET /runs/{run_id}/steps reads the turn from the step after the turn before's.","format":"int64","type":"integer","uniqueKey":"runs.oneOf.0.items.[INDEX].turns.oneOf.0.items.[INDEX].usage.last_step","typeLabel":"integer\u003cint64>"}},"required":["model_steps","prompt_tokens","completion_tokens","cost_microdollars"],"type":"object","uniqueKey":"runs.oneOf.0.items.[INDEX].turns.oneOf.0.items.[INDEX].usage","typeLabel":"object"}},"required":["turn","status"],"type":"object","uniqueKey":"runs.oneOf.0.items.[INDEX].turns.oneOf.0.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"runs.oneOf.0.items.[INDEX].turns.oneOf.0","typeLabel":"object[]"},{"description":"Every turn of an agent-mode run, oldest first: the task, then each follow-up sent with :sendMessage.","items":{"additionalProperties":false,"description":"One turn of an agent-mode run: what opened it, how it ended, and what it used.","properties":{"completed_at":{"description":"When the turn ended.","format":"date-time","type":"string"},"error":{"description":"Why the turn failed.","type":"string"},"message":{"description":"The message that opened the turn. Absent on turn 1, which works through the run's task.","type":"string"},"model":{"description":"The model the turn's steps called.","type":"string"},"output":{"description":"The turn's result, matching the run's output_schema."},"result_text":{"description":"The turn's result in a sentence.","type":"string"},"session_id":{"description":"The phone session the turn ran in.","type":"string"},"started_at":{"description":"When the turn started.","format":"date-time","type":"string"},"status":{"description":"The turn's status.","enum":["queued","running","paused","completed","failed","cancelled"],"type":"string"},"turn":{"description":"The turn's number, from 1.","format":"int64","type":"integer"},"usage":{"additionalProperties":false,"description":"What the turn's model steps used.","properties":{"completion_tokens":{"description":"Completion tokens across those steps.","format":"int64","type":"integer"},"cost_microdollars":{"description":"What those steps cost, in microdollars.","format":"int64","type":"integer"},"last_step":{"description":"The number of the turn's last step, answered or not: GET /runs/{run_id}/steps reads the turn from the step after the turn before's.","format":"int64","type":"integer"},"model_steps":{"description":"Model steps that got an answer.","format":"int64","type":"integer"},"prompt_tokens":{"description":"Prompt tokens across those steps.","format":"int64","type":"integer"}},"required":["model_steps","prompt_tokens","completion_tokens","cost_microdollars"],"type":"object"}},"required":["turn","status"],"type":"object"},"type":"null","uniqueKey":"runs.oneOf.0.items.[INDEX].turns.oneOf.1","typeLabel":"null"}],"uniqueKey":"runs.oneOf.0.items.[INDEX].turns","typeLabel":"object[] | null"},"usage":{"additionalProperties":false,"description":"What the run's model steps used, across its turns.","properties":{"completion_tokens":{"description":"Completion tokens across those steps.","format":"int64","type":"integer","isRequired":true,"uniqueKey":"runs.oneOf.0.items.[INDEX].usage.completion_tokens","typeLabel":"integer\u003cint64>"},"cost_microdollars":{"description":"What those steps cost, in microdollars.","format":"int64","type":"integer","isRequired":true,"uniqueKey":"runs.oneOf.0.items.[INDEX].usage.cost_microdollars","typeLabel":"integer\u003cint64>"},"model_steps":{"description":"Model steps that got an answer.","format":"int64","type":"integer","isRequired":true,"uniqueKey":"runs.oneOf.0.items.[INDEX].usage.model_steps","typeLabel":"integer\u003cint64>"},"prompt_tokens":{"description":"Prompt tokens across those steps.","format":"int64","type":"integer","isRequired":true,"uniqueKey":"runs.oneOf.0.items.[INDEX].usage.prompt_tokens","typeLabel":"integer\u003cint64>"}},"required":["model_steps","prompt_tokens","completion_tokens","cost_microdollars"],"type":"object","uniqueKey":"runs.oneOf.0.items.[INDEX].usage","typeLabel":"object"},"variables":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"runs.oneOf.0.items.[INDEX].variables.additionalProperties","typeLabel":"any"},"description":"The run's inputs. Deleted once the finished run is older than the plan's run data retention window (30 days by default).","type":"object","uniqueKey":"runs.oneOf.0.items.[INDEX].variables","typeLabel":"object"},"video_url":{"description":"URL for the run recording video.","type":"string","uniqueKey":"runs.oneOf.0.items.[INDEX].video_url","typeLabel":"string"}},"required":["id","mode","user_id","status","trigger","created_at","updated_at"],"type":"object","uniqueKey":"runs.oneOf.0.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"runs.oneOf.0","typeLabel":"object[]"},{"description":"The runs, in request order.","items":{"additionalProperties":false,"description":"A run: of a saved agent, or of an ad hoc task.","properties":{"agent_id":{"description":"The agent the run is of; absent on an ad hoc run.","format":"uuid","type":"string"},"agent_name":{"description":"The agent's name, on the run lists; absent on an ad hoc run.","type":"string"},"cancelled_at":{"description":"Timestamp when the run was cancelled.","format":"date-time","type":"string"},"completed_at":{"description":"Timestamp when the run finished.","format":"date-time","type":"string"},"created_at":{"description":"Timestamp when the run record was created.","format":"date-time","type":"string"},"error":{"description":"Why the run failed.","type":"string"},"id":{"description":"Run identifier.","format":"uuid","type":"string"},"input_request":{"additionalProperties":false,"description":"What a paused run asks a person; answer it with :resume.","properties":{"created_at":{"description":"When the run paused.","format":"date-time","type":"string"},"expires_at":{"description":"When the run stops waiting and fails with input_timeout: the earliest of its pause timeout, its time limit and the end of its session.","format":"date-time","type":"string"},"id":{"description":"The input request's id, which a resume names.","format":"uuid","type":"string"},"message":{"description":"The question, for the person answering.","type":"string"},"reason":{"description":"Why the run paused.","enum":["one_time_code_required","approval_required","choice_required","challenge_blocked","step_check_failed","caller_requested"],"type":"string"},"requested_by":{"description":"agent: the agent asked. code: the script asked, or failed with on_failure ask. caller: the run was paused through the API.","enum":["agent","code","caller"],"type":"string"},"response_schema":{"additionalProperties":{"oneOf":[{}]},"description":"The JSON Schema the answer must satisfy. Absent takes any answer.","type":"object"}},"required":["id","requested_by","reason","created_at","expires_at"],"type":"object"},"keep_alive_expires_at":{"description":"Until when an ended agent-mode run holds its phone: :sendMessage before then continues the run there; after it, start a new run.","format":"date-time","type":"string"},"max_cost_microdollars":{"description":"Most the run's model steps may cost, in microdollars.","format":"int64","type":"integer"},"max_steps":{"description":"Most model steps the run may take.","format":"int64","type":"integer"},"mode":{"description":"agent: an agent works the task through a model. code: the agent's script runs.","enum":["agent","code"],"type":"string"},"model":{"description":"The model the run's steps call, one of GET /models.","type":"string"},"network":{"description":"The network the run's code can reach: restricted reaches the phone only; internet adds the public internet.","enum":["restricted","internet"],"type":"string"},"output":{"description":"The run's result, which satisfies its output_schema."},"output_schema":{"description":"The JSON Schema the run's result must satisfy."},"pause_timeout_seconds":{"description":"Longest the run waits paused for an answer, in seconds.","format":"int64","type":"integer"},"phone_id":{"description":"Phone executing the run.","type":"string"},"recording_enabled":{"description":"An ad hoc run's own recording choice; absent takes the default (off), and a saved agent's run takes the agent's.","type":"boolean"},"repair":{"additionalProperties":false,"description":"On a code run: whether the agent took over after the script failed, and the fix it proposed.","properties":{"proposed_revision_id":{"description":"The fixed revision the repair proposed, waiting to be promoted. Absent when a fix for the revision was already waiting.","format":"uuid","type":"string"},"repaired":{"description":"The script failed and the agent took over.","type":"boolean"}},"required":["repaired"],"type":"object"},"result_text":{"description":"A short account of the run's result.","type":"string"},"revision_id":{"description":"The agent's revision the run was pinned to when it was made.","format":"uuid","type":"string"},"run_metadata":{"additionalProperties":{"oneOf":[{}]},"description":"Arbitrary metadata attached to the run.","type":"object"},"schedule_id":{"description":"The schedule that started the run, if one did.","format":"uuid","type":"string"},"session_id":{"description":"Session associated with this run.","format":"uuid","type":"string"},"start_at":{"description":"When the run was booked to start; absent for a run started on request.","format":"date-time","type":"string"},"start_timeout_seconds":{"description":"How long the queued run may wait for a phone before auto-cancel.","format":"int64","type":"integer"},"started_at":{"description":"Timestamp when the run began executing.","format":"date-time","type":"string"},"status":{"description":"Current lifecycle state of the run. paused: the run waits on a person; see input_request.","enum":["scheduled","queued","running","paused","completed","failed","cancelled"],"type":"string"},"stream_url":{"description":"The run's live event stream (Server-Sent Events), with a short-lived read-only token. Server clients can send the API key header instead.","type":"string"},"success":{"description":"Whether the run completed without error.","type":"boolean"},"targets":{"oneOf":[{"description":"The device the run drives.","items":{"additionalProperties":false,"description":"The device a run drives. Phones only for now, Android only.","properties":{"capabilities":{"additionalProperties":false,"description":"What the run needs of the phone.","properties":{"accessibility":{"description":"Run in accessibility mode, which needs a phone that supports it and your organization's access to accessibility mode.","type":"boolean"}},"type":"object"},"device_class":{"description":"The kind of device.","enum":["phone"],"type":"string"},"ownership":{"description":"dedicated: one of your organization's phones, the one phone_id names or any free one. shared: a phone from the shared fleet. Defaults to dedicated when phone_id is set, else shared.","enum":["dedicated","shared"],"type":"string"},"phone_id":{"description":"A dedicated phone of your organization to run on. Leave out for any of yours (ownership dedicated) or a shared phone.","type":"string"},"platform":{"description":"The device's platform (default android).","enum":["android"],"type":"string"}},"required":["device_class"],"type":"object"},"type":"array"},{"description":"The device the run drives.","items":{"additionalProperties":false,"description":"The device a run drives. Phones only for now, Android only.","properties":{"capabilities":{"additionalProperties":false,"description":"What the run needs of the phone.","properties":{"accessibility":{"description":"Run in accessibility mode, which needs a phone that supports it and your organization's access to accessibility mode.","type":"boolean"}},"type":"object"},"device_class":{"description":"The kind of device.","enum":["phone"],"type":"string"},"ownership":{"description":"dedicated: one of your organization's phones, the one phone_id names or any free one. shared: a phone from the shared fleet. Defaults to dedicated when phone_id is set, else shared.","enum":["dedicated","shared"],"type":"string"},"phone_id":{"description":"A dedicated phone of your organization to run on. Leave out for any of yours (ownership dedicated) or a shared phone.","type":"string"},"platform":{"description":"The device's platform (default android).","enum":["android"],"type":"string"}},"required":["device_class"],"type":"object"},"type":"null"}]},"task":{"description":"An agent-mode run's task: the ad hoc task, or the agent's instructions.","type":"string"},"telemetry_enabled":{"description":"An ad hoc run's own telemetry choice; absent takes the default (on), and a saved agent's run takes the agent's.","type":"boolean"},"timeout_seconds":{"description":"Longest the run may take, in seconds.","format":"int64","type":"integer"},"trace_expired_at":{"description":"When the trace recording was deleted.","format":"date-time","type":"string"},"trigger":{"description":"Trigger identifies how the run was initiated.","enum":["manual","scheduled","api"],"type":"string"},"turn":{"description":"An agent-mode run's current turn, from 1.","format":"int64","type":"integer"},"turns":{"oneOf":[{"description":"Every turn of an agent-mode run, oldest first: the task, then each follow-up sent with :sendMessage.","items":{"additionalProperties":false,"description":"One turn of an agent-mode run: what opened it, how it ended, and what it used.","properties":{"completed_at":{"description":"When the turn ended.","format":"date-time","type":"string"},"error":{"description":"Why the turn failed.","type":"string"},"message":{"description":"The message that opened the turn. Absent on turn 1, which works through the run's task.","type":"string"},"model":{"description":"The model the turn's steps called.","type":"string"},"output":{"description":"The turn's result, matching the run's output_schema."},"result_text":{"description":"The turn's result in a sentence.","type":"string"},"session_id":{"description":"The phone session the turn ran in.","type":"string"},"started_at":{"description":"When the turn started.","format":"date-time","type":"string"},"status":{"description":"The turn's status.","enum":["queued","running","paused","completed","failed","cancelled"],"type":"string"},"turn":{"description":"The turn's number, from 1.","format":"int64","type":"integer"},"usage":{"additionalProperties":false,"description":"What the turn's model steps used.","properties":{"completion_tokens":{"description":"Completion tokens across those steps.","format":"int64","type":"integer"},"cost_microdollars":{"description":"What those steps cost, in microdollars.","format":"int64","type":"integer"},"last_step":{"description":"The number of the turn's last step, answered or not: GET /runs/{run_id}/steps reads the turn from the step after the turn before's.","format":"int64","type":"integer"},"model_steps":{"description":"Model steps that got an answer.","format":"int64","type":"integer"},"prompt_tokens":{"description":"Prompt tokens across those steps.","format":"int64","type":"integer"}},"required":["model_steps","prompt_tokens","completion_tokens","cost_microdollars"],"type":"object"}},"required":["turn","status"],"type":"object"},"type":"array"},{"description":"Every turn of an agent-mode run, oldest first: the task, then each follow-up sent with :sendMessage.","items":{"additionalProperties":false,"description":"One turn of an agent-mode run: what opened it, how it ended, and what it used.","properties":{"completed_at":{"description":"When the turn ended.","format":"date-time","type":"string"},"error":{"description":"Why the turn failed.","type":"string"},"message":{"description":"The message that opened the turn. Absent on turn 1, which works through the run's task.","type":"string"},"model":{"description":"The model the turn's steps called.","type":"string"},"output":{"description":"The turn's result, matching the run's output_schema."},"result_text":{"description":"The turn's result in a sentence.","type":"string"},"session_id":{"description":"The phone session the turn ran in.","type":"string"},"started_at":{"description":"When the turn started.","format":"date-time","type":"string"},"status":{"description":"The turn's status.","enum":["queued","running","paused","completed","failed","cancelled"],"type":"string"},"turn":{"description":"The turn's number, from 1.","format":"int64","type":"integer"},"usage":{"additionalProperties":false,"description":"What the turn's model steps used.","properties":{"completion_tokens":{"description":"Completion tokens across those steps.","format":"int64","type":"integer"},"cost_microdollars":{"description":"What those steps cost, in microdollars.","format":"int64","type":"integer"},"last_step":{"description":"The number of the turn's last step, answered or not: GET /runs/{run_id}/steps reads the turn from the step after the turn before's.","format":"int64","type":"integer"},"model_steps":{"description":"Model steps that got an answer.","format":"int64","type":"integer"},"prompt_tokens":{"description":"Prompt tokens across those steps.","format":"int64","type":"integer"}},"required":["model_steps","prompt_tokens","completion_tokens","cost_microdollars"],"type":"object"}},"required":["turn","status"],"type":"object"},"type":"null"}]},"updated_at":{"description":"Timestamp of the last update to the run record.","format":"date-time","type":"string"},"usage":{"additionalProperties":false,"description":"What the run's model steps used, across its turns.","properties":{"completion_tokens":{"description":"Completion tokens across those steps.","format":"int64","type":"integer"},"cost_microdollars":{"description":"What those steps cost, in microdollars.","format":"int64","type":"integer"},"model_steps":{"description":"Model steps that got an answer.","format":"int64","type":"integer"},"prompt_tokens":{"description":"Prompt tokens across those steps.","format":"int64","type":"integer"}},"required":["model_steps","prompt_tokens","completion_tokens","cost_microdollars"],"type":"object"},"user_id":{"description":"User who initiated the run.","format":"uuid","type":"string"},"variables":{"additionalProperties":{"oneOf":[{}]},"description":"The run's inputs. Deleted once the finished run is older than the plan's run data retention window (30 days by default).","type":"object"},"video_url":{"description":"URL for the run recording video.","type":"string"}},"required":["id","mode","user_id","status","trigger","created_at","updated_at"],"type":"object"},"type":"null","isRequired":true,"uniqueKey":"runs.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"runs","typeLabel":"object[] | null"}},"required":["runs"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"runs":[{"created_at":"2023-11-07T05:31:56Z","id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","mode":"agent","status":"scheduled","trigger":"manual","updated_at":"2023-11-07T05:31:56Z","user_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","agent_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","agent_name":"\u003cstring>","cancelled_at":"2023-11-07T05:31:56Z","completed_at":"2023-11-07T05:31:56Z","error":"\u003cstring>","input_request":{"created_at":"2023-11-07T05:31:56Z","expires_at":"2023-11-07T05:31:56Z","id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","reason":"one_time_code_required","requested_by":"agent","message":"\u003cstring>","response_schema":{}},"keep_alive_expires_at":"2023-11-07T05:31:56Z","max_cost_microdollars":123,"max_steps":123,"model":"\u003cstring>","network":"restricted","output":"\u003cunknown>","output_schema":"\u003cunknown>","pause_timeout_seconds":123,"phone_id":"\u003cstring>","recording_enabled":true,"repair":{"repaired":true,"proposed_revision_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a"},"result_text":"\u003cstring>","revision_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","run_metadata":{},"schedule_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","session_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","start_at":"2023-11-07T05:31:56Z","start_timeout_seconds":123,"started_at":"2023-11-07T05:31:56Z","stream_url":"\u003cstring>","success":true,"targets":[{"device_class":"phone","capabilities":{"accessibility":true},"ownership":"dedicated","phone_id":"\u003cstring>","platform":"android"}],"task":"\u003cstring>","telemetry_enabled":true,"timeout_seconds":123,"trace_expired_at":"2023-11-07T05:31:56Z","turn":123,"turns":[{"status":"queued","turn":123,"completed_at":"2023-11-07T05:31:56Z","error":"\u003cstring>","message":"\u003cstring>","model":"\u003cstring>","output":"\u003cunknown>","result_text":"\u003cstring>","session_id":"\u003cstring>","started_at":"2023-11-07T05:31:56Z","usage":{"completion_tokens":123,"cost_microdollars":123,"model_steps":123,"prompt_tokens":123,"last_step":123}}],"usage":{"completion_tokens":123,"cost_microdollars":123,"model_steps":123,"prompt_tokens":123},"variables":{},"video_url":"\u003cstring>"}]}}},"exampleType":"generated"}},"description":"Created","exampleType":"generated"},"bbe1b34f-6349-4a56-9467-0ae6eb3a9720":{"content":{"application/problem+json":{"schema":{"additionalProperties":false,"description":"Error response, following RFC 9457 (Problem Details for HTTP APIs). Returned with a application/problem+json content type.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","examples":["Property foo is required but is missing."],"type":"string","uniqueKey":"detail","typeLabel":"string"},"errors":{"oneOf":[{"description":"Optional list of individual error details","items":{"additionalProperties":false,"description":"One specific problem within an error response, locating the offending part of the request.","properties":{"location":{"description":"Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'","type":"string","uniqueKey":"errors.oneOf.0.items.[INDEX].location","typeLabel":"string"},"message":{"description":"Error message text","type":"string","uniqueKey":"errors.oneOf.0.items.[INDEX].message","typeLabel":"string"},"value":{"description":"The value at the given location","uniqueKey":"errors.oneOf.0.items.[INDEX].value","typeLabel":"any"}},"type":"object","uniqueKey":"errors.oneOf.0.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"errors.oneOf.0","typeLabel":"object[]"},{"description":"Optional list of individual error details","items":{"additionalProperties":false,"description":"One specific problem within an error response, locating the offending part of the request.","properties":{"location":{"description":"Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'","type":"string"},"message":{"description":"Error message text","type":"string"},"value":{"description":"The value at the given location"}},"type":"object"},"type":"null","uniqueKey":"errors.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors","typeLabel":"object[] | null"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","examples":["https://example.com/error-log/abc123"],"format":"uri","type":"string","uniqueKey":"instance","typeLabel":"string\u003curi>"},"status":{"description":"HTTP status code","examples":[400],"format":"int64","type":"integer","uniqueKey":"status","typeLabel":"integer\u003cint64>"},"title":{"description":"A short, human-readable summary of the problem type. This value should not change between occurrences of the error.","examples":["Bad Request"],"type":"string","uniqueKey":"title","typeLabel":"string"},"type":{"default":"about:blank","description":"A URI reference to human-readable documentation for the error.","examples":["https://example.com/errors/example"],"format":"uri","type":"string","uniqueKey":"type","typeLabel":"string\u003curi>"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"detail":"Property foo is required but is missing.","errors":[{"location":"\u003cstring>","message":"\u003cstring>","value":"\u003cunknown>"}],"instance":"https://example.com/error-log/abc123","status":400,"title":"Bad Request","type":"https://example.com/errors/example"}}},"exampleType":"generated"}},"description":"Bad Request","exampleType":"generated"},"c3f08119-e6d7-468c-a202-29811bef001d":{"content":{"application/problem+json":{"schema":{"additionalProperties":false,"description":"Error response, following RFC 9457 (Problem Details for HTTP APIs). Returned with a application/problem+json content type.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","examples":["Property foo is required but is missing."],"type":"string","uniqueKey":"detail","typeLabel":"string"},"errors":{"oneOf":[{"description":"Optional list of individual error details","items":{"additionalProperties":false,"description":"One specific problem within an error response, locating the offending part of the request.","properties":{"location":{"description":"Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'","type":"string","uniqueKey":"errors.oneOf.0.items.[INDEX].location","typeLabel":"string"},"message":{"description":"Error message text","type":"string","uniqueKey":"errors.oneOf.0.items.[INDEX].message","typeLabel":"string"},"value":{"description":"The value at the given location","uniqueKey":"errors.oneOf.0.items.[INDEX].value","typeLabel":"any"}},"type":"object","uniqueKey":"errors.oneOf.0.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"errors.oneOf.0","typeLabel":"object[]"},{"description":"Optional list of individual error details","items":{"additionalProperties":false,"description":"One specific problem within an error response, locating the offending part of the request.","properties":{"location":{"description":"Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'","type":"string"},"message":{"description":"Error message text","type":"string"},"value":{"description":"The value at the given location"}},"type":"object"},"type":"null","uniqueKey":"errors.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors","typeLabel":"object[] | null"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","examples":["https://example.com/error-log/abc123"],"format":"uri","type":"string","uniqueKey":"instance","typeLabel":"string\u003curi>"},"status":{"description":"HTTP status code","examples":[400],"format":"int64","type":"integer","uniqueKey":"status","typeLabel":"integer\u003cint64>"},"title":{"description":"A short, human-readable summary of the problem type. This value should not change between occurrences of the error.","examples":["Bad Request"],"type":"string","uniqueKey":"title","typeLabel":"string"},"type":{"default":"about:blank","description":"A URI reference to human-readable documentation for the error.","examples":["https://example.com/errors/example"],"format":"uri","type":"string","uniqueKey":"type","typeLabel":"string\u003curi>"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"detail":"Property foo is required but is missing.","errors":[{"location":"\u003cstring>","message":"\u003cstring>","value":"\u003cunknown>"}],"instance":"https://example.com/error-log/abc123","status":400,"title":"Bad Request","type":"https://example.com/errors/example"}}},"exampleType":"generated"}},"description":"Payment Required","exampleType":"generated"},"fedbb03d-53a0-4bd4-b4a0-79c043691c77":{"content":{"application/problem+json":{"schema":{"additionalProperties":false,"description":"Error response, following RFC 9457 (Problem Details for HTTP APIs). Returned with a application/problem+json content type.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","examples":["Property foo is required but is missing."],"type":"string","uniqueKey":"detail","typeLabel":"string"},"errors":{"oneOf":[{"description":"Optional list of individual error details","items":{"additionalProperties":false,"description":"One specific problem within an error response, locating the offending part of the request.","properties":{"location":{"description":"Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'","type":"string","uniqueKey":"errors.oneOf.0.items.[INDEX].location","typeLabel":"string"},"message":{"description":"Error message text","type":"string","uniqueKey":"errors.oneOf.0.items.[INDEX].message","typeLabel":"string"},"value":{"description":"The value at the given location","uniqueKey":"errors.oneOf.0.items.[INDEX].value","typeLabel":"any"}},"type":"object","uniqueKey":"errors.oneOf.0.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"errors.oneOf.0","typeLabel":"object[]"},{"description":"Optional list of individual error details","items":{"additionalProperties":false,"description":"One specific problem within an error response, locating the offending part of the request.","properties":{"location":{"description":"Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'","type":"string"},"message":{"description":"Error message text","type":"string"},"value":{"description":"The value at the given location"}},"type":"object"},"type":"null","uniqueKey":"errors.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors","typeLabel":"object[] | null"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","examples":["https://example.com/error-log/abc123"],"format":"uri","type":"string","uniqueKey":"instance","typeLabel":"string\u003curi>"},"status":{"description":"HTTP status code","examples":[400],"format":"int64","type":"integer","uniqueKey":"status","typeLabel":"integer\u003cint64>"},"title":{"description":"A short, human-readable summary of the problem type. This value should not change between occurrences of the error.","examples":["Bad Request"],"type":"string","uniqueKey":"title","typeLabel":"string"},"type":{"default":"about:blank","description":"A URI reference to human-readable documentation for the error.","examples":["https://example.com/errors/example"],"format":"uri","type":"string","uniqueKey":"type","typeLabel":"string\u003curi>"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"detail":"Property foo is required but is missing.","errors":[{"location":"\u003cstring>","message":"\u003cstring>","value":"\u003cunknown>"}],"instance":"https://example.com/error-log/abc123","status":400,"title":"Bad Request","type":"https://example.com/errors/example"}}},"exampleType":"generated"}},"description":"Forbidden","exampleType":"generated"},"4424b0c3-581f-46cf-980d-5dd0162b9805":{"content":{"application/problem+json":{"schema":{"additionalProperties":false,"description":"Error response, following RFC 9457 (Problem Details for HTTP APIs). Returned with a application/problem+json content type.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","examples":["Property foo is required but is missing."],"type":"string","uniqueKey":"detail","typeLabel":"string"},"errors":{"oneOf":[{"description":"Optional list of individual error details","items":{"additionalProperties":false,"description":"One specific problem within an error response, locating the offending part of the request.","properties":{"location":{"description":"Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'","type":"string","uniqueKey":"errors.oneOf.0.items.[INDEX].location","typeLabel":"string"},"message":{"description":"Error message text","type":"string","uniqueKey":"errors.oneOf.0.items.[INDEX].message","typeLabel":"string"},"value":{"description":"The value at the given location","uniqueKey":"errors.oneOf.0.items.[INDEX].value","typeLabel":"any"}},"type":"object","uniqueKey":"errors.oneOf.0.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"errors.oneOf.0","typeLabel":"object[]"},{"description":"Optional list of individual error details","items":{"additionalProperties":false,"description":"One specific problem within an error response, locating the offending part of the request.","properties":{"location":{"description":"Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'","type":"string"},"message":{"description":"Error message text","type":"string"},"value":{"description":"The value at the given location"}},"type":"object"},"type":"null","uniqueKey":"errors.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors","typeLabel":"object[] | null"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","examples":["https://example.com/error-log/abc123"],"format":"uri","type":"string","uniqueKey":"instance","typeLabel":"string\u003curi>"},"status":{"description":"HTTP status code","examples":[400],"format":"int64","type":"integer","uniqueKey":"status","typeLabel":"integer\u003cint64>"},"title":{"description":"A short, human-readable summary of the problem type. This value should not change between occurrences of the error.","examples":["Bad Request"],"type":"string","uniqueKey":"title","typeLabel":"string"},"type":{"default":"about:blank","description":"A URI reference to human-readable documentation for the error.","examples":["https://example.com/errors/example"],"format":"uri","type":"string","uniqueKey":"type","typeLabel":"string\u003curi>"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"detail":"Property foo is required but is missing.","errors":[{"location":"\u003cstring>","message":"\u003cstring>","value":"\u003cunknown>"}],"instance":"https://example.com/error-log/abc123","status":400,"title":"Bad Request","type":"https://example.com/errors/example"}}},"exampleType":"generated"}},"description":"Not Found","exampleType":"generated"},"e2c0525d-126c-484d-9c9a-cb51c0ce310a":{"content":{"application/problem+json":{"schema":{"additionalProperties":false,"description":"Error response, following RFC 9457 (Problem Details for HTTP APIs). Returned with a application/problem+json content type.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","examples":["Property foo is required but is missing."],"type":"string","uniqueKey":"detail","typeLabel":"string"},"errors":{"oneOf":[{"description":"Optional list of individual error details","items":{"additionalProperties":false,"description":"One specific problem within an error response, locating the offending part of the request.","properties":{"location":{"description":"Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'","type":"string","uniqueKey":"errors.oneOf.0.items.[INDEX].location","typeLabel":"string"},"message":{"description":"Error message text","type":"string","uniqueKey":"errors.oneOf.0.items.[INDEX].message","typeLabel":"string"},"value":{"description":"The value at the given location","uniqueKey":"errors.oneOf.0.items.[INDEX].value","typeLabel":"any"}},"type":"object","uniqueKey":"errors.oneOf.0.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"errors.oneOf.0","typeLabel":"object[]"},{"description":"Optional list of individual error details","items":{"additionalProperties":false,"description":"One specific problem within an error response, locating the offending part of the request.","properties":{"location":{"description":"Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'","type":"string"},"message":{"description":"Error message text","type":"string"},"value":{"description":"The value at the given location"}},"type":"object"},"type":"null","uniqueKey":"errors.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors","typeLabel":"object[] | null"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","examples":["https://example.com/error-log/abc123"],"format":"uri","type":"string","uniqueKey":"instance","typeLabel":"string\u003curi>"},"status":{"description":"HTTP status code","examples":[400],"format":"int64","type":"integer","uniqueKey":"status","typeLabel":"integer\u003cint64>"},"title":{"description":"A short, human-readable summary of the problem type. This value should not change between occurrences of the error.","examples":["Bad Request"],"type":"string","uniqueKey":"title","typeLabel":"string"},"type":{"default":"about:blank","description":"A URI reference to human-readable documentation for the error.","examples":["https://example.com/errors/example"],"format":"uri","type":"string","uniqueKey":"type","typeLabel":"string\u003curi>"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"detail":"Property foo is required but is missing.","errors":[{"location":"\u003cstring>","message":"\u003cstring>","value":"\u003cunknown>"}],"instance":"https://example.com/error-log/abc123","status":400,"title":"Bad Request","type":"https://example.com/errors/example"}}},"exampleType":"generated"}},"description":"Conflict","exampleType":"generated"},"295fe0d8-8709-4141-a66e-f381adc05fa6":{"content":{"application/problem+json":{"schema":{"additionalProperties":false,"description":"Error response, following RFC 9457 (Problem Details for HTTP APIs). Returned with a application/problem+json content type.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","examples":["Property foo is required but is missing."],"type":"string","uniqueKey":"detail","typeLabel":"string"},"errors":{"oneOf":[{"description":"Optional list of individual error details","items":{"additionalProperties":false,"description":"One specific problem within an error response, locating the offending part of the request.","properties":{"location":{"description":"Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'","type":"string","uniqueKey":"errors.oneOf.0.items.[INDEX].location","typeLabel":"string"},"message":{"description":"Error message text","type":"string","uniqueKey":"errors.oneOf.0.items.[INDEX].message","typeLabel":"string"},"value":{"description":"The value at the given location","uniqueKey":"errors.oneOf.0.items.[INDEX].value","typeLabel":"any"}},"type":"object","uniqueKey":"errors.oneOf.0.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"errors.oneOf.0","typeLabel":"object[]"},{"description":"Optional list of individual error details","items":{"additionalProperties":false,"description":"One specific problem within an error response, locating the offending part of the request.","properties":{"location":{"description":"Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'","type":"string"},"message":{"description":"Error message text","type":"string"},"value":{"description":"The value at the given location"}},"type":"object"},"type":"null","uniqueKey":"errors.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors","typeLabel":"object[] | null"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","examples":["https://example.com/error-log/abc123"],"format":"uri","type":"string","uniqueKey":"instance","typeLabel":"string\u003curi>"},"status":{"description":"HTTP status code","examples":[400],"format":"int64","type":"integer","uniqueKey":"status","typeLabel":"integer\u003cint64>"},"title":{"description":"A short, human-readable summary of the problem type. This value should not change between occurrences of the error.","examples":["Bad Request"],"type":"string","uniqueKey":"title","typeLabel":"string"},"type":{"default":"about:blank","description":"A URI reference to human-readable documentation for the error.","examples":["https://example.com/errors/example"],"format":"uri","type":"string","uniqueKey":"type","typeLabel":"string\u003curi>"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"detail":"Property foo is required but is missing.","errors":[{"location":"\u003cstring>","message":"\u003cstring>","value":"\u003cunknown>"}],"instance":"https://example.com/error-log/abc123","status":400,"title":"Bad Request","type":"https://example.com/errors/example"}}},"exampleType":"generated"}},"description":"Unprocessable Entity","exampleType":"generated"},"7a13c394-9b41-4948-821e-86c35966a385":{"content":{"application/problem+json":{"schema":{"additionalProperties":false,"description":"Error response, following RFC 9457 (Problem Details for HTTP APIs). Returned with a application/problem+json content type.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","examples":["Property foo is required but is missing."],"type":"string","uniqueKey":"detail","typeLabel":"string"},"errors":{"oneOf":[{"description":"Optional list of individual error details","items":{"additionalProperties":false,"description":"One specific problem within an error response, locating the offending part of the request.","properties":{"location":{"description":"Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'","type":"string","uniqueKey":"errors.oneOf.0.items.[INDEX].location","typeLabel":"string"},"message":{"description":"Error message text","type":"string","uniqueKey":"errors.oneOf.0.items.[INDEX].message","typeLabel":"string"},"value":{"description":"The value at the given location","uniqueKey":"errors.oneOf.0.items.[INDEX].value","typeLabel":"any"}},"type":"object","uniqueKey":"errors.oneOf.0.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"errors.oneOf.0","typeLabel":"object[]"},{"description":"Optional list of individual error details","items":{"additionalProperties":false,"description":"One specific problem within an error response, locating the offending part of the request.","properties":{"location":{"description":"Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'","type":"string"},"message":{"description":"Error message text","type":"string"},"value":{"description":"The value at the given location"}},"type":"object"},"type":"null","uniqueKey":"errors.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors","typeLabel":"object[] | null"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","examples":["https://example.com/error-log/abc123"],"format":"uri","type":"string","uniqueKey":"instance","typeLabel":"string\u003curi>"},"status":{"description":"HTTP status code","examples":[400],"format":"int64","type":"integer","uniqueKey":"status","typeLabel":"integer\u003cint64>"},"title":{"description":"A short, human-readable summary of the problem type. This value should not change between occurrences of the error.","examples":["Bad Request"],"type":"string","uniqueKey":"title","typeLabel":"string"},"type":{"default":"about:blank","description":"A URI reference to human-readable documentation for the error.","examples":["https://example.com/errors/example"],"format":"uri","type":"string","uniqueKey":"type","typeLabel":"string\u003curi>"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"detail":"Property foo is required but is missing.","errors":[{"location":"\u003cstring>","message":"\u003cstring>","value":"\u003cunknown>"}],"instance":"https://example.com/error-log/abc123","status":400,"title":"Bad Request","type":"https://example.com/errors/example"}}},"exampleType":"generated"}},"description":"Internal Server Error","exampleType":"generated"}},"security":{"de39f868-e9c3-4fdf-8029-0914205c9e71":{"apiKeyAuth":{"description":"Customer API key (axl_ prefix).","in":"header","name":"X-Axilio-Api-Key","type":"apiKey","scopes":[],"schemeName":"apiKeyAuth"}}},"servers":{"374c87fc-e103-4302-b35a-9e65a062ab81":{"url":"https://api.axilio.ai/api/v1","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"description":"Customer API key (axl_ prefix).","in":"header","name":"X-Axilio-Api-Key","type":"apiKey","scopes":[],"schemeName":"apiKeyAuth"},"schema":{"title":"X-Axilio-Api-Key","type":"string","description":"Customer API key (axl_ prefix).","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKeyAuth","name":"X-Axilio-Api-Key"}],"title":"apiKeyAuth"}]},"originalFileLocation":"api-reference/openapi-backend.json"},"subdomain":"axilio","siteName":"Axilio","title":"Start several runs - Axilio","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-02T00:48:43.883Z","originalFileLocation":"api-reference/rest/runs/start-several-runs.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Starts up to 1000 runs, each as POST /runs would. All are created or none is; an error names the request it is for. A batch may not name the same dedicated phone twice. The batch is refused with 409 while your organization is at its concurrency limit; its runs beyond the limit wait in the queue for a free slot.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Axilio\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/axilio/9qr2QoS9ifDUVIsa/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/axilio/9qr2QoS9ifDUVIsa/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/axilio/9qr2QoS9ifDUVIsa/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/axilio/9qr2QoS9ifDUVIsa/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/axilio/9qr2QoS9ifDUVIsa/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/axilio/9qr2QoS9ifDUVIsa/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/axilio/9qr2QoS9ifDUVIsa/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/axilio/9qr2QoS9ifDUVIsa/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/axilio/9qr2QoS9ifDUVIsa/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Start several runs - Axilio\">\u003cmeta data-mint-head property=\"og:description\" content=\"Starts up to 1000 runs, each as POST /runs would. All are created or none is; an error names the request it is for. A batch may not name the same dedicated phone twice. The batch is refused with 409 while your organization is at its concurrency limit; its runs beyond the limit wait in the queue for a free slot.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Axilio\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.axilio.ai/api-reference/rest/runs/start-several-runs\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://axilio.mintlify.app/_mintlify/api/og/v2?division=Runs\u0026amp;title=Start+several+runs\u0026amp;description=Starts+up+to+1000+runs%2C+each+as+POST+%2Fruns+would.+All+are+created+or+none+is%3B+an+error+names+the+request+it+is+for.+A+batch+may+not+name+the+same+dedicated+phon\u0026amp;theme=5b7e7e591b641ec888de4b36\u0026amp;signature=c815e7728005f54a3403beaabbf04e0599c38437ae0ecd5762d80b7aef173024\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Start several runs - Axilio\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Starts up to 1000 runs, each as POST /runs would. All are created or none is; an error names the request it is for. A batch may not name the same dedicated phone twice. The batch is refused with 409 while your organization is at its concurrency limit; its runs beyond the limit wait in the queue for a free slot.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://axilio.mintlify.app/_mintlify/api/og/v2?division=Runs\u0026amp;title=Start+several+runs\u0026amp;description=Starts+up+to+1000+runs%2C+each+as+POST+%2Fruns+would.+All+are+created+or+none+is%3B+an+error+names+the+request+it+is+for.+A+batch+may+not+name+the+same+dedicated+phon\u0026amp;theme=5b7e7e591b641ec888de4b36\u0026amp;signature=c815e7728005f54a3403beaabbf04e0599c38437ae0ecd5762d80b7aef173024\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/axilio/9qr2QoS9ifDUVIsa/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Axilio\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#10B981\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.axilio.ai/api-reference/rest/runs/start-several-runs\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/rest/runs/start-several-runs.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.axilio.ai/#organization\",\"name\":\"Axilio\",\"url\":\"https://docs.axilio.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/axilio/MykQsDZmWO83uzQl/logo/axilio-light.svg?fit=max\u0026auto=format\u0026n=MykQsDZmWO83uzQl\u0026q=85\u0026s=dae3bccd996c953fc0d057e5e3ea864b\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.axilio.ai#website\",\"name\":\"Axilio\",\"url\":\"https://docs.axilio.ai\",\"publisher\":{\"@id\":\"https://docs.axilio.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.axilio.ai/api-reference/rest/runs/start-several-runs#webpage\",\"url\":\"https://docs.axilio.ai/api-reference/rest/runs/start-several-runs\",\"name\":\"Start several runs\",\"description\":\"Starts up to 1000 runs, each as POST /runs would. All are created or none is; an error names the request it is for. A batch may not name the same dedicated phone twice. The batch is refused with 409 while your organization is at its concurrency limit; its runs beyond the limit wait in the queue for a free slot.\",\"dateModified\":\"2026-11-02T00:48:43.883Z\",\"isPartOf\":{\"@id\":\"https://docs.axilio.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.axilio.ai/api-reference/rest/runs/start-several-runs#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.axilio.ai/api-reference/rest/runs/start-several-runs#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"REST API\",\"item\":\"https://docs.axilio.ai/api-reference/rest/agents/list-agents\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Runs\",\"item\":\"https://docs.axilio.ai/api-reference/rest/runs/list-a-sessions-telemetry-frames\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Start several runs\",\"item\":\"https://docs.axilio.ai/api-reference/rest/runs/start-several-runs\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.axilio.ai/api-reference/rest/runs/start-several-runs#apireference\",\"headline\":\"Start several runs\",\"name\":\"Start several runs\",\"description\":\"Starts up to 1000 runs, each as POST /runs would. All are created or none is; an error names the request it is for. A batch may not name the same dedicated phone twice. The batch is refused with 409 while your organization is at its concurrency limit; its runs beyond the limit wait in the queue for a free slot.\",\"url\":\"https://docs.axilio.ai/api-reference/rest/runs/start-several-runs\",\"mainEntityOfPage\":{\"@id\":\"https://docs.axilio.ai/api-reference/rest/runs/start-several-runs#webpage\"},\"dateModified\":\"2026-11-02T00:48:43.883Z\",\"publisher\":{\"@id\":\"https://docs.axilio.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.axilio.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Axilio\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Axilio","nav":{"global":null,"tabs":[{"tab":"Platform","icon":"cloud","pages":[{"title":"Platform","href":""}]},{"tab":"Drivers","icon":"hand-pointer","pages":[{"title":"Drivers","href":"/drivers/overview"}]},{"tab":"API Reference","icon":"code","groups":[{"group":"Overview","icon":"circle-info","pages":[{"title":"API Reference","sidebarTitle":"Overview","href":"/api-reference/overview"},{"title":"Versioning \u0026 Deprecation","sidebarTitle":"Versioning \u0026 deprecation","href":"/api-reference/versioning"},{"title":"API changes, October 2026","sidebarTitle":"October 2026 changes","href":"/api-reference/api-changes-2026-10"}]},{"group":"Device Control Protocol","icon":"plug","pages":[{"title":"Device Control Protocol","sidebarTitle":"Overview","href":"/api-reference/dcp/overview"},{"title":"Drive a phone with raw DCP","sidebarTitle":"Raw usage","href":"/api-reference/dcp/raw-usage"},{"title":"Reconnect and resume","sidebarTitle":"Reconnect \u0026 resume","href":"/api-reference/dcp/reconnect"},{"title":"DCP message reference","sidebarTitle":"Message reference","href":"/api-reference/dcp/reference"}]},{"group":"REST API","icon":"server","pages":[{"group":"Agents","pages":[{"title":"List agents","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /agents","href":"/api-reference/rest/agents/list-agents"},{"title":"Create an agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json post /agents","href":"/api-reference/rest/agents/create-an-agent"},{"title":"Get an agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /agents/{agent_id}","href":"/api-reference/rest/agents/get-an-agent"},{"title":"Delete an agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json delete /agents/{agent_id}","href":"/api-reference/rest/agents/delete-an-agent"},{"title":"Update an agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json patch /agents/{agent_id}","href":"/api-reference/rest/agents/update-an-agent"},{"title":"List an agent's revisions","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /agents/{agent_id}/revisions","href":"/api-reference/rest/agents/list-an-agents-revisions"},{"title":"Add a revision","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json post /agents/{agent_id}/revisions","href":"/api-reference/rest/agents/add-a-revision"},{"title":"Get a revision","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /agents/{agent_id}/revisions/{revision_id}","href":"/api-reference/rest/agents/get-a-revision"},{"title":"Promote a proposed fix","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json post /agents/{agent_id}/revisions/{revision_id}:promote","href":"/api-reference/rest/agents/promote-a-proposed-fix"},{"title":"List schedules","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /agents/{agent_id}/schedules","href":"/api-reference/rest/agents/list-schedules"},{"title":"Create a schedule","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json post /agents/{agent_id}/schedules","href":"/api-reference/rest/agents/create-a-schedule"},{"title":"Get a schedule","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /agents/{agent_id}/schedules/{schedule_id}","href":"/api-reference/rest/agents/get-a-schedule"},{"title":"Delete a schedule","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json delete /agents/{agent_id}/schedules/{schedule_id}","href":"/api-reference/rest/agents/delete-a-schedule"},{"title":"Update a schedule","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json patch /agents/{agent_id}/schedules/{schedule_id}","href":"/api-reference/rest/agents/update-a-schedule"},{"title":"Pause a schedule","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json post /agents/{agent_id}/schedules/{schedule_id}:pause","href":"/api-reference/rest/agents/pause-a-schedule"},{"title":"Resume a schedule","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json post /agents/{agent_id}/schedules/{schedule_id}:resume","href":"/api-reference/rest/agents/resume-a-schedule"},{"title":"Run a schedule now","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json post /agents/{agent_id}/schedules/{schedule_id}:run","href":"/api-reference/rest/agents/run-a-schedule-now"},{"title":"Roll an agent back to an earlier revision","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json post /agents/{agent_id}:rollback","href":"/api-reference/rest/agents/roll-an-agent-back-to-an-earlier-revision"}]},{"group":"API Keys","pages":[{"title":"List API keys","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /api-keys","href":"/api-reference/rest/api-keys/list-api-keys"},{"title":"Create an API key","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json post /api-keys","href":"/api-reference/rest/api-keys/create-an-api-key"},{"title":"Delete an API key","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json delete /api-keys/{key_id}","href":"/api-reference/rest/api-keys/delete-an-api-key"}]},{"group":"Billing","pages":[{"title":"Get auto-recharge settings","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /billing/auto-recharge","href":"/api-reference/rest/billing/get-auto-recharge-settings"},{"title":"Update auto-recharge settings","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json patch /billing/auto-recharge","href":"/api-reference/rest/billing/update-auto-recharge-settings"},{"title":"Get account balance","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /billing/balance","href":"/api-reference/rest/billing/get-account-balance"},{"title":"Get balance statement","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /billing/balance/statement","href":"/api-reference/rest/billing/get-balance-statement"},{"title":"List balance transactions","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /billing/balance/transactions","href":"/api-reference/rest/billing/list-balance-transactions"},{"title":"List billing history","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /billing/history","href":"/api-reference/rest/billing/list-billing-history"},{"title":"Get an invoice PDF URL","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /billing/history/{invoice_id}/pdf","href":"/api-reference/rest/billing/get-an-invoice-pdf-url"},{"title":"List phone rentals","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /billing/phone-rental-subscriptions","href":"/api-reference/rest/billing/list-phone-rentals"},{"title":"Get current plan","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /billing/subscription","href":"/api-reference/rest/billing/get-current-plan"},{"title":"Get usage-alert settings","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /billing/usage-alerts","href":"/api-reference/rest/billing/get-usage-alert-settings"},{"title":"Update usage-alert settings","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json patch /billing/usage-alerts","href":"/api-reference/rest/billing/update-usage-alert-settings"}]},{"group":"Conversations","pages":[{"title":"List conversations","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /conversations","href":"/api-reference/rest/conversations/list-conversations"},{"title":"Get a conversation","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /conversations/{conversation_id}","href":"/api-reference/rest/conversations/get-a-conversation"},{"title":"Delete a conversation","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json delete /conversations/{conversation_id}","href":"/api-reference/rest/conversations/delete-a-conversation"},{"title":"List a conversation's messages","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /conversations/{conversation_id}/messages","href":"/api-reference/rest/conversations/list-a-conversations-messages"},{"title":"Reply in a conversation","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json post /conversations/{conversation_id}/messages","href":"/api-reference/rest/conversations/reply-in-a-conversation"}]},{"group":"Files","pages":[{"title":"List the org's files","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /files","href":"/api-reference/rest/files/list-the-orgs-files"},{"title":"Register a file upload","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json post /files","href":"/api-reference/rest/files/register-a-file-upload"},{"title":"Get a file","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /files/{file_id}","href":"/api-reference/rest/files/get-a-file"},{"title":"Delete a file","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json delete /files/{file_id}","href":"/api-reference/rest/files/delete-a-file"},{"title":"Update a file","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json patch /files/{file_id}","href":"/api-reference/rest/files/update-a-file"},{"title":"Mark an upload complete","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json post /files/{file_id}:complete","href":"/api-reference/rest/files/mark-an-upload-complete"},{"title":"List a session's captured files","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /phones/sessions/{session_id}/files","href":"/api-reference/rest/files/list-a-sessions-captured-files"}]},{"group":"Messages","pages":[{"title":"List messages","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /messages","href":"/api-reference/rest/messages/list-messages"},{"title":"Send a message","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json post /messages","href":"/api-reference/rest/messages/send-a-message"},{"title":"Get message metrics","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /messages/metrics","href":"/api-reference/rest/messages/get-message-metrics"},{"title":"Get a message","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /messages/{message_id}","href":"/api-reference/rest/messages/get-a-message"},{"title":"Delete a message","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json delete /messages/{message_id}","href":"/api-reference/rest/messages/delete-a-message"}]},{"group":"Models","pages":[{"title":"List models","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /models","href":"/api-reference/rest/models/list-models"}]},{"group":"Organization","pages":[{"title":"Get the caller's organization","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /organization","href":"/api-reference/rest/organization/get-the-callers-organization"},{"title":"List pending invitations","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /organization/invitations","href":"/api-reference/rest/organization/list-pending-invitations"},{"title":"List the organization's members","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /organization/members","href":"/api-reference/rest/organization/list-the-organizations-members"}]},{"group":"Phones","pages":[{"title":"List the org's phones","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /phones","href":"/api-reference/rest/phones/list-the-orgs-phones"},{"title":"Phone availability summary","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /phones/availability","href":"/api-reference/rest/phones/phone-availability-summary"},{"title":"List sessions","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /phones/sessions","href":"/api-reference/rest/phones/list-sessions"},{"title":"Get a session","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /phones/sessions/{session_id}","href":"/api-reference/rest/phones/get-a-session"},{"title":"Get a session recording","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /phones/sessions/{session_id}/recording","href":"/api-reference/rest/phones/get-a-session-recording"},{"title":"Mint a live-view token","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json post /phones/sessions/{session_id}:createLiveViewToken","href":"/api-reference/rest/phones/mint-a-live-view-token"},{"title":"List supported apps","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /phones/supported-apps","href":"/api-reference/rest/phones/list-supported-apps"},{"title":"Get a phone","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /phones/{phone_id}","href":"/api-reference/rest/phones/get-a-phone"},{"title":"Update a phone","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json patch /phones/{phone_id}","href":"/api-reference/rest/phones/update-a-phone"},{"title":"List a phone's file deliveries","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /phones/{phone_id}/deliveries","href":"/api-reference/rest/phones/list-a-phones-file-deliveries"},{"title":"Deliver a library file to a phone","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json post /phones/{phone_id}/deliveries","href":"/api-reference/rest/phones/deliver-a-library-file-to-a-phone"},{"title":"Get one file delivery","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /phones/{phone_id}/deliveries/{delivery_id}","href":"/api-reference/rest/phones/get-one-file-delivery"},{"title":"Get a phone's live screen preview","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /phones/{phone_id}/preview","href":"/api-reference/rest/phones/get-a-phones-live-screen-preview"},{"title":"Release a phone","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json post /phones/{phone_id}:deallocate","href":"/api-reference/rest/phones/release-a-phone"},{"title":"Wipe a phone (not available)","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json post /phones/{phone_id}:wipe","href":"/api-reference/rest/phones/wipe-a-phone-not-available"},{"title":"Allocate a phone","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json post /phones:allocate","href":"/api-reference/rest/phones/allocate-a-phone"},{"title":"Stream a session's telemetry","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /realtime/sessions/{session_id}/events","href":"/api-reference/rest/phones/stream-a-sessions-telemetry"}]},{"group":"Runs","pages":[{"title":"List a session's telemetry frames","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /phones/sessions/{session_id}/frames","href":"/api-reference/rest/runs/list-a-sessions-telemetry-frames"},{"title":"Stream a run's events","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /realtime/runs/{run_id}/events","href":"/api-reference/rest/runs/stream-a-runs-events"},{"title":"List runs","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /runs","href":"/api-reference/rest/runs/list-runs"},{"title":"Start a run","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json post /runs","href":"/api-reference/rest/runs/start-a-run"},{"title":"Get run metrics","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /runs/metrics","href":"/api-reference/rest/runs/get-run-metrics"},{"title":"Get a run","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /runs/{run_id}","href":"/api-reference/rest/runs/get-a-run"},{"title":"List a run's events","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /runs/{run_id}/events","href":"/api-reference/rest/runs/list-a-runs-events"},{"title":"Get a run's script","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /runs/{run_id}/script","href":"/api-reference/rest/runs/get-a-runs-script"},{"title":"List a run's steps","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /runs/{run_id}/steps","href":"/api-reference/rest/runs/list-a-runs-steps"},{"title":"Cancel a run","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json post /runs/{run_id}:cancel","href":"/api-reference/rest/runs/cancel-a-run"},{"title":"Pause a run","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json post /runs/{run_id}:pause","href":"/api-reference/rest/runs/pause-a-run"},{"title":"Resume a paused run","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json post /runs/{run_id}:resume","href":"/api-reference/rest/runs/resume-a-paused-run"},{"title":"Send a message to a run","description":"Sends a person's message to an agent-mode run. To a run that is running or paused, the run's model reads it before its next step, as a turn from the person running the task, and the run's stream carries it as a user_message event, its body the message, once the run's phone has it. A message never resumes a paused run: answer the pause with :resume. A run holds at most 20 unread messages, and a message past that is refused, or one that arrives as the run finishes, which may then never be read or shown. To a run that ended (completed, failed or cancelled) while it still holds its phone (keep_alive_expires_at is in the future), the message starts the run's next turn on the same phone, and the run goes back to queued. Returns the run as it is. A code run, a queued or scheduled run, a run whose hold has ended, or a run whose phone cannot take messages yet is 409; an empty message, or one over 64 KiB, is 400.","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json post /runs/{run_id}:sendMessage","href":"/api-reference/rest/runs/send-a-message-to-a-run"},{"title":"Start several runs","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json post /runs:batchCreate","href":"/api-reference/rest/runs/start-several-runs"}]},{"group":"Sessions","pages":[{"title":"Get phone session metrics","description":"Returns your organization's ended phone sessions over a window as points: one per hour or day in time_zone (and per group with group_by), each with the sessions, their phone time in seconds and what it cost. A session counts in the bucket it was billed in, as it ended, dedicated phones' at no cost; sessions still going are not counted. The window defaults to the last 7 days and may start at most a year back; hour buckets need a window of 7 days or less.","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /sessions/metrics","href":"/api-reference/rest/sessions/get-phone-session-metrics"}]},{"group":"Skill","pages":[{"title":"Agent skill markdown","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /skill","href":"/api-reference/rest/skill/agent-skill-markdown"}]},{"group":"Usage","pages":[{"title":"List inference calls","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /usage/inferences","href":"/api-reference/rest/usage/list-inference-calls"},{"title":"Get usage metrics","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /usage/metrics","href":"/api-reference/rest/usage/get-usage-metrics"},{"title":"List phone sessions with cost","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /usage/sessions","href":"/api-reference/rest/usage/list-phone-sessions-with-cost"}]},{"group":"Webhooks","pages":[{"title":"List the delivery log","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /webhooks/deliveries","href":"/api-reference/rest/webhooks/list-the-delivery-log"},{"title":"Get a delivery-log event","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /webhooks/deliveries/{event_id}","href":"/api-reference/rest/webhooks/get-a-delivery-log-event"},{"title":"List delivery attempts for an event","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /webhooks/deliveries/{event_id}/attempts","href":"/api-reference/rest/webhooks/list-delivery-attempts-for-an-event"},{"title":"Replay a delivery","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json post /webhooks/deliveries/{event_id}:replay","href":"/api-reference/rest/webhooks/replay-a-delivery"},{"title":"Send a test event","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json post /webhooks/deliveries:sendTest","href":"/api-reference/rest/webhooks/send-a-test-event"},{"title":"List webhook endpoints","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /webhooks/endpoints","href":"/api-reference/rest/webhooks/list-webhook-endpoints"},{"title":"Register a webhook endpoint","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json post /webhooks/endpoints","href":"/api-reference/rest/webhooks/register-a-webhook-endpoint"},{"title":"Get a webhook endpoint","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /webhooks/endpoints/{endpoint_id}","href":"/api-reference/rest/webhooks/get-a-webhook-endpoint"},{"title":"Delete a webhook endpoint","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json delete /webhooks/endpoints/{endpoint_id}","href":"/api-reference/rest/webhooks/delete-a-webhook-endpoint"},{"title":"List delivery attempts to an endpoint","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /webhooks/endpoints/{endpoint_id}/attempts","href":"/api-reference/rest/webhooks/list-delivery-attempts-to-an-endpoint"},{"title":"Rotate a webhook endpoint's signing secret","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json post /webhooks/endpoints/{endpoint_id}:rotateSecret","href":"/api-reference/rest/webhooks/rotate-a-webhook-endpoints-signing-secret"},{"title":"List subscribable event types","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /webhooks/event-types","href":"/api-reference/rest/webhooks/list-subscribable-event-types"},{"title":"Get delivery metrics","deprecated":null,"version":null,"openapi":"/api-reference/openapi-backend.json get /webhooks/metrics","href":"/api-reference/rest/webhooks/get-delivery-metrics"}]}]},{"group":"Argus API","icon":"eye","pages":[{"title":"Models: list","sidebarTitle":"Models: list","openapi":"api-reference/openapi-argus.json GET /api/v1/models","href":"/api-reference/argus/list-models"},{"title":"Screenshots: detect","sidebarTitle":"Screenshots: detect","openapi":"api-reference/openapi-argus.json POST /api/v1/screenshots:detect","href":"/api-reference/argus/screenshots-detect"},{"title":"Screenshots: locate","sidebarTitle":"Screenshots: locate","openapi":"api-reference/openapi-argus.json POST /api/v1/screenshots:locate","href":"/api-reference/argus/screenshots-locate"},{"title":"Elements: locate","sidebarTitle":"Elements: locate","openapi":"api-reference/openapi-argus.json POST /api/v1/elements:locate","href":"/api-reference/argus/elements-locate"},{"group":"Elements","pages":[{"title":"Locate Element","deprecated":null,"version":null,"openapi":"/api-reference/openapi-argus.json post /api/v1/elements:locate","href":"/api-reference/elements/locate-element"}]},{"group":"Models","pages":[{"title":"List Models","deprecated":null,"version":null,"openapi":"/api-reference/openapi-argus.json get /api/v1/models","href":"/api-reference/models/list-models"}]},{"group":"Screenshots","pages":[{"title":"Detect Screenshot","deprecated":null,"version":null,"openapi":"/api-reference/openapi-argus.json post /api/v1/screenshots:detect","href":"/api-reference/screenshots/detect-screenshot"},{"title":"Locate In Screenshot","deprecated":null,"version":null,"openapi":"/api-reference/openapi-argus.json post /api/v1/screenshots:locate","href":"/api-reference/screenshots/locate-in-screenshot"}]}]}]},{"tab":"GitHub ↗","href":"https://github.com/orgs/axilioai/repositories"},{"tab":"Dashboard ↗","href":"https://app.axilio.ai/dashboard/axilio/sessions"}]},"basePath":"","title":"Start several runs - Axilio","buildId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","deploymentId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-DX1Meug0.js","utils-B_OMIQVC.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-ChxhRPMa.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CuKvD8Iv.js","snippetPresets-C5d7p2hp.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","Page-BAvA99GL.js","ApiExamples-CfHcE8m4.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C1zZV314.js","shallow-CmQhqCJn.js","getApiPlaygroundDisplay-YRo9s1O7.js","CodeSnippet-RN1MTdfk.js","CodeSnippets-DKLPHxJA.js","getPastedJson-bz0M41mU.js","icon-CsmhpPrv.js","MethodPill-CNGsVE77.js","DuplicateIcon-DilfU_Z2.js","createIcon-BdsYzQck.js","DynamicMarkdown-CbqEDjbV.js","SectionHeading-O6hXpFCN.js","axios-vUo_bRtp.js","Markdown-nKm-uidQ.js","clsx-ClVdStUn.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CIQkMg3R.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-ImrFS4Fy.js"]}