[{"data":1,"prerenderedAt":47},["ShallowReactive",2],{"$f3dd8j6mmxt5a9":3},{"href":4,"title":5,"description":6,"kind":7,"mark":7,"planned":8,"contributors":9,"provenance":7,"express":8,"bridge":8,"html":10,"headings":11},"\u002Fdocs\u002Fwork\u002Fruns","Runs","One run of a task, start to finish: what each status means, what you can do with a run, and why one lands on Blockers.",null,false,[],"\u003Ch2 id=\"what-a-run-is\">What a run is\u003C\u002Fh2>\n\u003Cp>A \u003Ca href=\"\u002Fdocs\u002Fwork\u002Ftasks\">task\u003C\u002Fa> is a definition, and it never runs. A \u003Cstrong>run\u003C\u002Fstrong> is one pass of one version of it: an\ninput, a member doing the work, the tool calls it made, its cost, and how it ended. \u003Cstrong>Runs\u003C\u002Fstrong> in the portal lists\nevery run; \u003Cstrong>Executions\u003C\u002Fstrong> groups the runs that handed work to each other (see\n\u003Ca href=\"\u002Fdocs\u002Fwork\u002Fexecutions\">Executions\u003C\u002Fa>).\u003C\u002Fp>\n\u003Cp>A run keeps the version of the task it started on. Publishing a new version while it runs changes nothing for it. A run\nstill waiting its turn has not started, so it starts on whichever version is current then, and its log shows the\nchange.\u003C\u002Fp>\n\u003Ch2 id=\"statuses\">Statuses\u003C\u002Fh2>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Status\u003C\u002Fth>\n\u003Cth>What it means\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>pending\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Waiting for its turn, holding nothing: a start, successor, retry or recovery whose task or member is busy, or a successor with a delay that has not passed. It is queued when the task and member are free.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>queued\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Ready to start. It starts when there is room under your concurrent-run limits.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>running\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The member is working: calling the model and its tools.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>waiting_on_gate\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Stopped before a gated call, or at a question, until you decide. See \u003Ca href=\"\u002Fdocs\u002Fcontrol\u002Fgates\">Gates\u003C\u002Fa>.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>paused_spend\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Held before it starts because a spend cap was reached. It is queued again when you raise a day cap or turn spend limits off. See \u003Ca href=\"\u002Fdocs\u002Fcontrol\u002Fspend\">Spend and models\u003C\u002Fa>.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>blocked\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Parked for a reason outside the task, such as a refused credential or a provider outage, or because it needs a person. See \u003Ca href=\"#blocked-runs\">Blocked runs\u003C\u002Fa>.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>succeeded\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Finished. It may have named an \u003Ca href=\"\u002Fdocs\u002Fwork\u002Fhandoffs#named-outcomes\">outcome\u003C\u002Fa>.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>failed\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Finished with a failure that belongs to the task, with a reason.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>cancelled\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Stopped: by a person, by a rejected gate, or by a decision that waited too long.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>skipped_overlap\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>A scheduled start that found the task busy, or every member holding its role busy. It never ran. It is kept for 24 hours.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>A run at a gate holds neither its task nor its member: while it waits for you, other work can start.\u003C\u002Fp>\n\u003Ch2 id=\"how-many-run-at-once\">How many run at once\u003C\u002Fh2>\n\u003Cp>A task has one run under way at a time, and so does a member. A run waiting at a gate does not count.\u003C\u002Fp>\n\u003Cp>Across the enterprise, \u003Cstrong>Concurrent runs\u003C\u002Fstrong> on \u003Cstrong>Enterprise\u003C\u002Fstrong> sets how many runs may be \u003Ccode>running\u003C\u002Fcode> at once, 1 unless\nyou change it. A team can have its own, lower limit. A run counts on every team of the member doing it, the teams\nthey sit on or lead, and starts only when each of them has room. A run over a limit stays \u003Ccode>queued\u003C\u002Fcode> until a slot frees.\u003C\u002Fp>\n\u003Ch2 id=\"the-run-page\">The run page\u003C\u002Fh2>\n\u003Cp>A run's page shows:\u003C\u002Fp>\n\u003Cul>\n\u003Cli>the task and version it ran (and whether that is still the current version), its execution and the links the\nwork produced, and its cost, top right;\u003C\u002Fli>\n\u003Cli>what came before it and what it hands to next, including successors that are waiting, delayed, or were not\nstarted and why;\u003C\u002Fli>\n\u003Cli>its status and how long it ran;\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Run events\u003C\u002Fstrong>, newest first: every step, tool call and decision, each with its details. A run that failed, was\nblocked or was skipped says why at the top;\u003C\u002Fli>\n\u003Cli>any gate waiting on you, with its decision buttons in place.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>\u003Cstrong>Show log\u003C\u002Fstrong> opens the run's full record. The page updates every few seconds while you are looking at it.\u003C\u002Fp>\n\u003Ch2 id=\"what-you-can-do-with-a-run\">What you can do with a run\u003C\u002Fh2>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Action\u003C\u002Fth>\n\u003Cth>On\u003C\u002Fth>\n\u003Cth>What it does\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>Cancel\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>A run that is pending, queued, running, waiting, paused or blocked\u003C\u002Ftd>\n\u003Ctd>Stops it. A gated call it was waiting on never runs, and it starts no successors.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>Retry as new run\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>A run that has finished, was skipped, or is blocked\u003C\u002Ftd>\n\u003Ctd>Starts a \u003Cstrong>new\u003C\u002Fstrong> run with the same input, on the task's current version, linked to the old one. It starts fresh: it does not carry on the old run's conversation. If the task or member is busy, it waits as \u003Ccode>pending\u003C\u002Fcode>. A blocked run you retry is cancelled.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>Clear\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>A failed run, or a pipeline that stopped, on \u003Cstrong>Blockers\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>Takes it off \u003Cstrong>Blockers\u003C\u002Fstrong>. The run and its history stay on \u003Cstrong>Runs\u003C\u002Fstrong>, unchanged.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>\u003Cstrong>Clear all\u003C\u002Fstrong> on \u003Cstrong>Blockers\u003C\u002Fstrong> clears every failed run in one go. \u003Cstrong>Retry all\u003C\u002Fstrong> and \u003Cstrong>Cancel all\u003C\u002Fstrong> on its \u003Cstrong>Blocked\n(resumes automatically)\u003C\u002Fstrong> section retry or cancel every run there, each as its own \u003Cstrong>Retry\u003C\u002Fstrong> or \u003Cstrong>Cancel\u003C\u002Fstrong> would. A\nrun that cannot be retried or cancelled is named with its reason, and the rest still go. Runs under \u003Cstrong>Needs a\ndecision\u003C\u002Fstrong> are not touched.\u003C\u002Fp>\n\u003Cp>A run cancelled while it waited on a gate or a question leaves a note on \u003Cstrong>Blockers\u003C\u002Fstrong> that a decision was stopped, so\nthe work is not silently dropped.\u003C\u002Fp>\n\u003Ch2 id=\"blocked-runs\">Blocked runs\u003C\u002Fh2>\n\u003Cp>A failure the task could not have prevented does not fail the run. It \u003Cstrong>blocks\u003C\u002Fstrong> it: the run holds nothing, starts no\nsuccessors, and resumes as a continuation, carrying on the same conversation, when the cause clears.\u003C\u002Fp>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Cause\u003C\u002Fth>\n\u003Cth>Examples\u003C\u002Fth>\n\u003Cth>When it resumes\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>Credentials\u003C\u002Ftd>\n\u003Ctd>A model key or tool connection refused or missing; no model connected\u003C\u002Ftd>\n\u003Ctd>As soon as a credential in your enterprise changes, and hourly. With no model connected, as soon as a model connection the run can use is added\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Provider outage\u003C\u002Ftd>\n\u003Ctd>A timeout, a rate limit, a 5xx from the model or a tool, a tool server that cannot be reached\u003C\u002Ftd>\n\u003Ctd>Automatically after 2, 5, 15 and 30 minutes, or as soon as credentials change. After an hour it stops trying and waits for you\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Model\u003C\u002Ftd>\n\u003Ctd>The chosen model does not exist or is unavailable\u003C\u002Ftd>\n\u003Ctd>When the model answers again; after an hour it waits for you\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Capacity\u003C\u002Ftd>\n\u003Ctd>A Claude seat's usage limit is used up\u003C\u002Ftd>\n\u003Ctd>When the limit resets\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Definition\u003C\u002Ftd>\n\u003Ctd>The task, as written, cannot run\u003C\u002Ftd>\n\u003Ctd>After you edit the task\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>A decision\u003C\u002Ftd>\n\u003Ctd>A \u003Ca href=\"\u002Fdocs\u002Fwork\u002Fhandoffs#loops-and-the-loop-cap\">loop cap\u003C\u002Fa>, a question that timed out, a decision that was cancelled\u003C\u002Ftd>\n\u003Ctd>Never by itself: a person retries or cancels it\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>On \u003Cstrong>Blockers\u003C\u002Fstrong>, \u003Cstrong>Retry\u003C\u002Fstrong> starts a new run and \u003Cstrong>Cancel\u003C\u002Fstrong> closes the blocked one. When you retry work about an issue\nor pull request, its \u003Ca href=\"\u002Fdocs\u002Fwork\u002Fhandoffs#loops-and-the-loop-cap\">loop caps\u003C\u002Fa> and the number of times tasks may retry\nit both start again.\u003C\u002Fp>\n\u003Cp>A tool call that fails is retried a few times first. What happens then depends on the failure: an outage blocks the\nrun; an error in the call itself (a bad argument, a refusal from the tool) goes back to the model to correct.\u003C\u002Fp>\n\u003Ch2 id=\"failed-runs\">Failed runs\u003C\u002Fh2>\n\u003Cp>A run fails when the failure is the task's own. Some of the reasons you will see:\u003C\u002Fp>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Reason\u003C\u002Fth>\n\u003Cth>What happened\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>run_stalled\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The run recorded nothing for 30 minutes and was stopped.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>llm_max_steps\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The run used every step it is allowed without finishing. See \u003Ca href=\"#steps\">Steps\u003C\u002Fa> for how many a run gets and how a task asks for more.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>tool_not_on_task\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The model called a tool the task does not list.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>unresolved_tool_errors\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The model finished while a tool call it needed had never gone through, even after one chance to correct it. The reason names the tools, then the first one's error text as the tool gave it.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>A failed run starts its successors on \u003Ccode>failed\u003C\u002Fcode> and \u003Ccode>terminal\u003C\u002Fcode>, if the task has any.\u003C\u002Fp>\n\u003Ch3 id=\"steps\">Steps\u003C\u002Fh3>\n\u003Cp>Each model turn of a run is one step. A run that reaches its last step fails with \u003Ccode>llm_max_steps\u003C\u002Fcode>, even if it has\nalready done most of its work. How many steps a run gets is the first of these that is set:\u003C\u002Fp>\n\u003Col>\n\u003Cli>The run's own input \u003Ccode>maxSteps\u003C\u002Fcode>. A run it hands work on to is not given it. A task that declares a number input\n\u003Ccode>maxSteps\u003C\u002Fcode> with a default starts each run with that default.\u003C\u002Fli>\n\u003Cli>The operator's \u003Ccode>LLM_MAX_STEPS\u003C\u002Fcode> setting, for every run on the deployment.\u003C\u002Fli>\n\u003Cli>The task version's \u003Ccode>spend.maxSteps\u003C\u002Fcode>, next to its other spend limits. Set it on the task form, or send it with the\nversion's \u003Ccode>spend\u003C\u002Fcode>. It applies to every run of that version, a run started by a handoff included.\u003C\u002Fli>\n\u003Cli>The default for the task's tools: 120 steps for a task that works in a repository or drives a browser, 24 for any\nother task.\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cp>No run gets more than 400 steps, whatever is set. A version's \u003Ccode>spend.maxSteps\u003C\u002Fcode> must be a whole number from 1 to 400:\npublishing any other value is refused with \u003Ccode>spend_max_steps_invalid\u003C\u002Fcode>, and nothing is rounded or capped for you. It can\nlower the default as well as raise it. Leave it out to keep the default.\u003C\u002Fp>\n\u003Cp>The run is told its step budget beside its spend limit. Once it has used 80% of its steps, it gets one note saying how\nmany it has used and how many are left, so it can finish its handoff and name its outcome before the last step.\u003C\u002Fp>\n\u003Ch3 id=\"when-the-worker-is-lost\">When the worker is lost\u003C\u002Fh3>\n\u003Cp>If the process running a run disappears (a restart, a crash, a deploy), the run is marked failed with the reason\n\u003Ccode>worker_lost\u003C\u002Fcode> and one continuation starts, carrying on the same conversation from its last completed step. Edits\nit had not pushed are gone, and a call that was in flight when the worker went may or may not have landed. If the\ncontinuation is lost too, it is blocked, as an outage.\u003C\u002Fp>\n\u003Cp>The failure also says why the worker went, in its \u003Ccode>cause\u003C\u002Fcode>. The reason stays \u003Ccode>worker_lost\u003C\u002Fcode> whatever the cause, and the\ncontinuation and the block work the same way for each. If the cause cannot be looked up at that moment, the failure\nhas no \u003Ccode>cause\u003C\u002Fcode>, and the continuation still starts.\u003C\u002Fp>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>\u003Ccode>cause\u003C\u002Fcode>\u003C\u002Fth>\n\u003Cth>What happened\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>killed\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The worker was told it was being replaced and had started finishing its runs, but it was stopped before this one ended. The failure says when the worker was told and when it was due to be stopped.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>replaced\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>A release replaced the worker without warning it first. The failure names the worker and build that took over.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>host_lost\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Nothing recorded explains it: a crash, the machine running out of memory, the machine itself going, or a restart on the same build.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Ch2 id=\"blockers\">Blockers\u003C\u002Fh2>\n\u003Cp>\u003Cstrong>Blockers\u003C\u002Fstrong> is the list of what cannot move without someone:\u003C\u002Fp>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Section\u003C\u002Fth>\n\u003Cth>What is in it\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>No LLM capacity\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>A model connection with a limit used up: which limit (a rate limit, a spend limit with its period, or a balance) and when it resets, with \u003Cstrong>Raise limit\u003C\u002Fstrong> or \u003Cstrong>Add credits\u003C\u002Fstrong>.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>Models unavailable\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>A model a tier runs that the provider says does not exist, when no other model could be chosen for the tier.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>Task definitions\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>Active tasks that will not run cleanly as written.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>Team health\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>A team with no lead or an overdue weekly retro, and a KPI someone has to fix: a team with no key KPI, a key KPI with no target, a KPI overdue for a reading, or a proposal waiting on the CEO. A KPI that is only amber or red is not listed here: its light shows on \u003Cstrong>Enterprise\u003C\u002Fstrong> in the menu.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>Needs a decision\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>Work that stopped for a person: it reached its loop cap, waits on the CEO, or escalated. When a gate holds the decision, \u003Cstrong>Decide\u003C\u002Fstrong> opens it.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>Pipeline stopped\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>Work whose newest run failed, or ended on an outcome nothing routes, in the last 14 days.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>Blocked (resumes automatically)\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>Blocked runs, each with its cause. Most resume by themselves; the table above says which wait for you. \u003Cstrong>Retry all\u003C\u002Fstrong> and \u003Cstrong>Cancel all\u003C\u002Fstrong> act on every one.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>Failed\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>Failed runs nobody has cleared or retried.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>Stalled\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>Runs that have recorded nothing for 30 minutes, with \u003Cstrong>Cancel\u003C\u002Fstrong>.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>Paused spend\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>Runs paused by a spend cap, with \u003Cstrong>Raise cap\u003C\u002Fstrong>.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n\u003Cp>Each run row names its task and the teammate it worked as (or its team), says what happened in one plain sentence,\nsuch as &quot;Keyword research finished, but nothing was set to run next.&quot;, and offers the fix as a button: \u003Cstrong>Choose\nwhat runs next\u003C\u002Fstrong> opens the task, \u003Cstrong>Retry\u003C\u002Fstrong> and \u003Cstrong>Cancel\u003C\u002Fstrong> act on the run. \u003Cstrong>Open run\u003C\u002Fstrong> shows the run itself, with its\nfull reason. An escalated run reads \u003Cstrong>Needs a human decision\u003C\u002Fstrong>, with what the open gate asks and \u003Cstrong>Decide\u003C\u002Fstrong>, which\nopens the run that asked, where you answer it. The gate can be one asked about an earlier run of the same issue or\nPR, since each retry replaces the row.\u003C\u002Fp>\n\u003Cp>A failed run leaves \u003Cstrong>Failed\u003C\u002Fstrong> when you clear it, or when a retry, recovery or resume starts from it. Gates are not on\n\u003Cstrong>Blockers\u003C\u002Fstrong>; they are on \u003Cstrong>Gates\u003C\u002Fstrong>. Self-improvement proposals are not either; they are on \u003Cstrong>Self-Improvement\u003C\u002Fstrong>.\u003C\u002Fp>\n\u003Ch2 id=\"over-the-api\">Over the API\u003C\u002Fh2>\n\u003Cp>With an \u003Ca href=\"\u002Fdocs\u002Fapi\u002Fauthentication\">API token\u003C\u002Fa>:\u003C\u002Fp>\n\u003Cdiv class=\"prose__table\">\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Call\u003C\u002Fth>\n\u003Cth>Scope\u003C\u002Fth>\n\u003Cth>What it does\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>POST \u002Fv1\u002Ftasks\u002F{id}\u002Fruns\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>tasks:write\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Start a run, with its input as the body. The run waits as \u003Ccode>pending\u003C\u002Fcode> if the task, or every member holding its role, is busy.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>GET \u002Fv1\u002Fruns\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>runs:read\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Runs, filtered by \u003Ccode>taskId\u003C\u002Fcode>, \u003Ccode>taskVersionId\u003C\u002Fcode> or \u003Ccode>status\u003C\u002Fcode>.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>GET \u002Fv1\u002Fruns\u002F{id}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>runs:read\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>One run and its events.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>GET \u002Fv1\u002Fruns\u002F{id}\u002Flog\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>runs:read\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Its full log, once stored.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>POST \u002Fv1\u002Fruns\u002F{id}\u002Fretry\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>runs:write\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Retry as a new run.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>POST \u002Fv1\u002Fruns\u002F{id}\u002Fcancel\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>runs:write\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Cancel it.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>POST \u002Fv1\u002Fruns\u002F{id}\u002Fclear\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>runs:write\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Clear it from \u003Cstrong>Blockers\u003C\u002Fstrong>.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>GET \u002Fv1\u002Fblockers\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>blockers:read\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Everything on \u003Cstrong>Blockers\u003C\u002Fstrong>.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003C\u002Fdiv>\n",[12,16,19,22,25,28,31,34,38,41,44],{"id":13,"text":14,"level":15,"planned":8},"what-a-run-is","What a run is",2,{"id":17,"text":18,"level":15,"planned":8},"statuses","Statuses",{"id":20,"text":21,"level":15,"planned":8},"how-many-run-at-once","How many run at once",{"id":23,"text":24,"level":15,"planned":8},"the-run-page","The run page",{"id":26,"text":27,"level":15,"planned":8},"what-you-can-do-with-a-run","What you can do with a run",{"id":29,"text":30,"level":15,"planned":8},"blocked-runs","Blocked runs",{"id":32,"text":33,"level":15,"planned":8},"failed-runs","Failed runs",{"id":35,"text":36,"level":37,"planned":8},"steps","Steps",3,{"id":39,"text":40,"level":37,"planned":8},"when-the-worker-is-lost","When the worker is lost",{"id":42,"text":43,"level":15,"planned":8},"blockers","Blockers",{"id":45,"text":46,"level":15,"planned":8},"over-the-api","Over the API",1794928143972]