Files
skills/public/managed-agents-scheduled-deployments.html
zeekayandHanzo Dev 9e10c1c10e Each llms index points at the other two
hanzoskills.com/llms.txt now opens with the install line, the API
reference index and the company index, so an agent that lands on any
one of the three can find the rest.

robots.txt claimed 537 documents while llms.txt counts 920. The number
is gone from robots.txt; llms.txt derives it.

public/ is regenerated from scripts/site.py, which it had fallen
behind: the copy-prompt menu and agent bar were in the generator and
not in the committed pages. tests/site.mjs passes against the result.

Co-authored-by: Hanzo Dev <[email protected]>
2026-09-11 00:27:59 -07:00

317 lines
23 KiB
HTML
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<!doctype html>
<html lang="en"><head>
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
<title>managed-agents-scheduled-deployments</title>
<meta name="color-scheme" content="dark">
<style>
/* Committed to one visual world: a dark instrument panel. No light variant —
the dot field and the hairline rules only read on black, and a naive
inversion would wash both out. Every colour is painted explicitly so the page
never borrows a host background. */
@font-face{font-family:'Zen';src:url('/fonts/Zen-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
@font-face{font-family:'Zen';src:url('/fonts/Zen-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
@font-face{font-family:'Zen Pixel Square';src:url('/fonts/ZenPixel-Square.woff2') format('woff2');font-style:normal;font-display:swap}
:root{
--ink:#f4f4f2; --soft:#9c9c98; --faint:#6a6a66; --ground:#000; --panel:#0a0a0a;
--line:#232323; --line-hi:#3a3a3a; --accent:#f4f4f2;
--font-zen-sans:'Zen',-apple-system,BlinkMacSystemFont,"Segoe UI",Helvetica,Arial,sans-serif;
--font-zen-mono:'Zen Mono',ui-monospace,"SF Mono",SFMono-Regular,Menlo,Consolas,monospace;
--font-zen-pixel-square:'Zen Pixel Square',monospace;
--mono:var(--font-zen-mono);
--sans:var(--font-zen-sans);
/* Controls are pills and surfaces are soft, as on hanzo.ai. */
--r:999px; --r-soft:14px;
}
*{box-sizing:border-box}
html{-webkit-text-size-adjust:100%}
body{margin:0;background:var(--ground);color:var(--ink);font-family:var(--sans);
font-size:16px;line-height:1.65;-webkit-font-smoothing:antialiased}
.wrap{max-width:60rem;margin:0 auto;padding:0 1.75rem}
/* The dot field. A halftone made of one repeating radial-gradient, faded out
along the diagonal by a mask so it reads as a wave rather than wallpaper. */
/* No overflow clip here: the dot field is inset to the box already, and a clip
would cut off the copy-prompt menu. */
.hero{position:relative;border-bottom:1px solid var(--line)}
.hero::before{content:"";position:absolute;inset:0;
background-image:radial-gradient(var(--line-hi) 1px, transparent 1px);
background-size:7px 7px;
-webkit-mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
pointer-events:none}
.hero .wrap{position:relative;padding-top:5.5rem;padding-bottom:4rem}
nav{border-bottom:1px solid var(--line)}
nav .in{max-width:60rem;margin:0 auto;padding:1.1rem 1.75rem;display:flex;
justify-content:space-between;align-items:center;gap:1rem}
.brand{font-family:var(--mono);font-size:.85rem;letter-spacing:.14em;
text-transform:uppercase;color:var(--ink);text-decoration:none;
display:inline-flex;align-items:center;gap:.6rem}
.brand i{font-style:normal;color:var(--faint)}
.mark{width:1.15em;height:1.15em;display:block;flex:0 0 auto}
nav a.up{font-family:var(--mono);font-size:.72rem;letter-spacing:.14em;
text-transform:uppercase;color:var(--soft);text-decoration:none}
nav a.up:hover{color:var(--ink)}
h1{font-family:var(--mono);font-size:clamp(2rem,5.4vw,3.4rem);line-height:1.12;
letter-spacing:-.02em;margin:0 0 1.1rem;font-weight:500;text-wrap:balance}
h1 em{font-style:normal;color:var(--faint)}
.lede{color:var(--soft);font-size:1.05rem;max-width:52ch;margin:0 0 2.25rem}
.btns{display:flex;flex-wrap:wrap;gap:.7rem;margin:0 0 .5rem;align-items:center}
.btn{display:inline-flex;align-items:center;gap:.5rem;font-family:var(--mono);
font-size:.72rem;letter-spacing:.14em;text-transform:uppercase;
padding:.8rem 1.4rem;border:1px solid var(--line-hi);border-radius:var(--r);
color:var(--ink);text-decoration:none;background:transparent;cursor:pointer;
line-height:1.2;font-weight:400}
.btn:hover{background:#141414;text-decoration:none;border-color:var(--soft)}
.btn.solid{background:var(--ink);color:#000;border-color:var(--ink)}
.btn.solid:hover{background:#d8d8d4}
.btn .chev{width:.7em;height:.7em;flex:0 0 auto;transition:transform .15s ease}
.btn[aria-expanded="true"] .chev{transform:rotate(180deg)}
/* Copy-prompt selector. Each row copies the prompt for its own target. */
.copy{position:relative;display:inline-flex}
.menu{position:absolute;top:calc(100% + .5rem);left:0;z-index:20;min-width:21rem;
background:var(--panel);border:1px solid var(--line-hi);border-radius:var(--r-soft);
padding:.4rem;display:flex;flex-direction:column;
box-shadow:0 12px 32px rgba(0,0,0,.75)}
.menu[hidden]{display:none}
.mi{display:flex;align-items:center;gap:.7rem;width:100%;text-align:left;
padding:.62rem .8rem;border:0;border-radius:calc(var(--r-soft) - .35rem);
background:transparent;color:var(--ink);font-family:var(--mono);font-size:.76rem;
letter-spacing:.04em;text-decoration:none;cursor:pointer;line-height:1.3;
white-space:nowrap}
.mi:hover,.mi:focus-visible{background:#181818;outline:none}
.mi .mark{width:1.05rem;height:1.05rem;color:var(--soft)}
.mi:hover .mark{color:var(--ink)}
.mi u{margin-left:auto;color:var(--faint);text-decoration:none;font-size:.68rem;
letter-spacing:.1em;text-transform:uppercase}
/* Works-with bar: one scrolling row, name and mark per agent. */
.strip{border-bottom:1px solid var(--line);background:var(--panel)}
.strip .in{max-width:60rem;margin:0 auto;padding:.9rem 1.75rem;display:flex;
align-items:center;gap:1.25rem;font-family:var(--mono);font-size:.72rem;
letter-spacing:.1em;text-transform:uppercase;color:var(--faint)}
.strip b{color:var(--soft);font-weight:400;flex:0 0 auto;
border-right:1px solid var(--line);padding-right:1.25rem;align-self:stretch;
display:flex;align-items:center}
.bar{display:flex;align-items:center;gap:.5rem;flex:1 1 auto;min-width:0;
overflow-x:auto;scrollbar-width:none;scroll-snap-type:x proximity;
-webkit-overflow-scrolling:touch;
-webkit-mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent);
mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent)}
.bar::-webkit-scrollbar{display:none}
.agent{display:inline-flex;align-items:center;gap:.45rem;flex:0 0 auto;
padding:.4rem .85rem;border:1px solid var(--line);border-radius:var(--r);
color:var(--soft);white-space:nowrap;scroll-snap-align:start;
text-decoration:none;background:var(--ground)}
.agent:hover{color:var(--ink);border-color:var(--line-hi);text-decoration:none}
.agent .mark{width:.95rem;height:.95rem}
h2{font-family:var(--mono);font-size:1.1rem;letter-spacing:-.01em;margin:2.75rem 0 .75rem;font-weight:500}
h3{font-size:1rem;margin:2rem 0 .5rem;font-weight:600}
h4,h5,h6{font-size:.94rem;margin:1.5rem 0 .5rem;font-weight:600}
p{margin:0 0 1rem;max-width:70ch}
ul,ol{margin:0 0 1rem;padding-left:1.35rem;max-width:70ch}
li{margin:.22rem 0}
a{color:var(--ink);text-decoration:underline;text-underline-offset:3px;
text-decoration-color:var(--line-hi)}
a:hover{text-decoration-color:var(--ink)}
a:focus-visible{outline:1px solid var(--ink);outline-offset:3px}
code{font-family:var(--mono);font-size:.85em;background:var(--panel);
border:1px solid var(--line);border-radius:5px;padding:.1em .36em}
pre{background:var(--panel);border:1px solid var(--line);padding:1rem 1.1rem;
border-radius:var(--r-soft);overflow-x:auto;margin:0 0 1.25rem}
pre code{background:none;border:0;padding:0;font-size:.82rem;line-height:1.7}
blockquote{margin:0 0 1rem;padding-left:1rem;border-left:1px solid var(--line-hi);color:var(--soft)}
hr{border:0;border-top:1px solid var(--line);margin:2.5rem 0}
table{border-collapse:collapse;width:100%;margin:0 0 1.25rem;font-size:.92rem;
display:block;overflow-x:auto}
th,td{border:1px solid var(--line);padding:.5rem .7rem;text-align:left}
.curl{display:block;background:var(--panel);border:1px solid var(--line);
border-radius:var(--r-soft);padding:.95rem 1.1rem;font-family:var(--mono);
font-size:.8rem;color:var(--soft);overflow-x:auto;margin:0 0 2.5rem;
white-space:pre;line-height:1.9}
.curl b{color:var(--ink);font-weight:400}
.curl i{font-style:normal;color:var(--faint)}
/* index */
#q{width:100%;padding:.85rem 1.2rem;font-family:var(--mono);font-size:.85rem;color:var(--ink);
background:var(--panel);border:1px solid var(--line);border-radius:var(--r);margin:0 0 .6rem}
#q::placeholder{color:var(--faint);text-transform:uppercase;letter-spacing:.1em;font-size:.72rem}
#q:focus{outline:none;border-color:var(--soft)}
#count{color:var(--faint);font-family:var(--mono);font-size:.72rem;letter-spacing:.1em;
text-transform:uppercase;margin:0 0 2rem}
.cat{margin:2.5rem 0 .5rem;font-family:var(--mono);font-size:.7rem;letter-spacing:.16em;
text-transform:uppercase;color:var(--faint);border-bottom:1px solid var(--line);
padding-bottom:.45rem}
.row{display:block;padding:.6rem .9rem;margin:0 -.9rem;border-bottom:1px solid var(--line);
border-radius:var(--r-soft);text-decoration:none}
.row:hover{background:#0a0a0a}
.nm{font-family:var(--mono);font-size:.84rem;color:var(--ink);display:block}
.ds{color:var(--soft);font-size:.9rem;display:block;margin-top:.12rem}
footer{margin-top:4rem;padding:2rem 0 4rem;border-top:1px solid var(--line);
color:var(--faint);font-size:.85rem}
footer a{color:var(--soft)}
.fmap{display:grid;gap:1.75rem;grid-template-columns:repeat(auto-fit,minmax(11rem,1fr));
margin:0 0 2rem;font-size:.85rem}
.fmap b{display:block;font-family:var(--mono);font-size:.68rem;letter-spacing:.16em;
text-transform:uppercase;color:var(--faint);font-weight:400;margin:0 0 .6rem;
border-bottom:1px solid var(--line);padding-bottom:.4rem}
.fmap a{display:inline-block;color:var(--ink);text-decoration:none;margin:.3rem .35rem 0 0}
.fmap a:hover{text-decoration:underline}
.fmap div{color:var(--faint);line-height:1.5}
.fend{border-top:1px solid var(--line);padding-top:1.25rem;font-size:.82rem}
@media (max-width:640px){
.hero .wrap{padding-top:3.25rem;padding-bottom:2.75rem}
.btns{gap:.5rem}
.btn{padding:.75rem 1.15rem;font-size:.68rem}
.copy,.copy .btn{width:100%;justify-content:center}
.menu{left:0;right:0;min-width:0}
.strip .in{flex-direction:column;align-items:flex-start;gap:.6rem;padding:.9rem 1.75rem}
.strip b{border-right:0;padding-right:0}
.bar{width:100%}
}
</style>
<link rel="alternate" type="text/markdown" href="/managed-agents-scheduled-deployments.md">
<link rel="icon" href="/favicon.svg">
<link rel="canonical" href="https://hanzoskills.com/managed-agents-scheduled-deployments">
</head>
<!-- Reading this with a machine? Every page here is also plain markdown.
This one: https://hanzoskills.com/managed-agents-scheduled-deployments.md
Index: https://hanzoskills.com/llms.txt
Corpus: https://hanzoskills.com/all.md
Append .md to any path for the markdown twin. -->
<body>
<nav><div class="in">
<a class="brand" href="/"><svg class="mark" viewBox="0 0 67 67" fill="currentColor" aria-hidden="true"><path d="M22.21 67V44.6369H0V67H22.21Z"/><path d="M66.7038 22.3184H22.2534L0.0878906 44.6367H44.4634L66.7038 22.3184Z"/><path d="M22.21 0H0V22.3184H22.21V0Z"/><path d="M66.7198 0H44.5098V22.3184H66.7198V0Z"/><path d="M66.7198 67V44.6369H44.5098V67H66.7198Z"/></svg> HANZO<i>SKILLS</i></a>
<a class="up" href="/">All skills</a>
</div></nav>
<div class="wrap">
<h1>managed-agents-scheduled-deployments</h1><p class="lede">A scheduled deployment runs an agent on a recurring cron schedule — each firing creates a session autonomously.</p><h1>Managed Agents — Scheduled Deployments</h1>
<p>A <strong>scheduled deployment</strong> runs an agent on a recurring cron schedule — each firing creates a session autonomously. Use it for predictable-cadence work: nightly triage, weekly compliance scans, hourly monitors.</p>
<p>Requires the <code>managed-agents-2026-04-01</code> beta header (the SDK sets it automatically for <code>client.beta.deployments.<em></code> / <code>client.beta.deployment_runs.</em></code> calls).</p>
<h2>Create a deployment</h2>
<p>A deployment bundles everything a session needs (agent, environment, optional files / GitHub / memory stores / vaults) plus a <code>schedule</code> and the <code>initial_events</code> that kick off each run:</p>
<ul><li><code>agent</code> and <code>environment_id</code> are required — same shapes as <code>sessions.create</code> (see <code>shared/managed-agents-core.md</code>).</li><li><code>initial_events</code> must contain at least one starting event — a <code>user.message</code> <strong>or</strong> a <code>user.define_outcome</code>. (A deployment&#x27;s <code>initial_events</code> also accepts <code>system.message</code>, which a session&#x27;s does not.)</li><li><code>schedule</code> takes a cron <code>expression</code> and an IANA <code>timezone</code>. Minute-level granularity is the maximum.</li></ul>
<pre><code class="lang-bash">curl -fsSL https://api.anthropic.com/v1/deployments \
-H &quot;x-api-key: $ANTHROPIC_API_KEY&quot; \
-H &quot;anthropic-version: 2023-06-01&quot; \
-H &quot;anthropic-beta: managed-agents-2026-04-01&quot; \
-H &quot;content-type: application/json&quot; \
-d @- &lt;&lt;EOF
{
&quot;name&quot;: &quot;Weekly compliance scan&quot;,
&quot;agent&quot;: &quot;$AGENT_ID&quot;,
&quot;environment_id&quot;: &quot;$ENVIRONMENT_ID&quot;,
&quot;initial_events&quot;: [
{&quot;type&quot;: &quot;user.message&quot;, &quot;content&quot;: [{&quot;type&quot;: &quot;text&quot;, &quot;text&quot;: &quot;Run the weekly compliance scan.&quot;}]}
],
&quot;schedule&quot;: {
&quot;type&quot;: &quot;cron&quot;,
&quot;expression&quot;: &quot;0 20 * * 5&quot;,
&quot;timezone&quot;: &quot;America/New_York&quot;
}
}
EOF</code></pre>
<pre><code class="lang-python">deployment = client.beta.deployments.create(
name=&quot;Weekly compliance scan&quot;,
agent=agent.id,
environment_id=environment.id,
initial_events=[
{
&quot;type&quot;: &quot;user.message&quot;,
&quot;content&quot;: [{&quot;type&quot;: &quot;text&quot;, &quot;text&quot;: &quot;Run the weekly compliance scan.&quot;}],
},
],
schedule={
&quot;type&quot;: &quot;cron&quot;,
&quot;expression&quot;: &quot;0 20 * * 5&quot;,
&quot;timezone&quot;: &quot;America/New_York&quot;,
},
)</code></pre>
<p>The response is a deployment object (<code>depl_</code> ID prefix). Check <code>schedule.upcoming_runs_at</code> — the next fire times — to confirm the schedule parses the way you intended:</p>
<pre><code class="lang-json">{
&quot;id&quot;: &quot;depl_01xyz&quot;,
&quot;status&quot;: &quot;active&quot;,
&quot;paused_reason&quot;: null,
&quot;schedule&quot;: {
&quot;type&quot;: &quot;cron&quot;,
&quot;expression&quot;: &quot;0 20 * * 5&quot;,
&quot;timezone&quot;: &quot;America/New_York&quot;,
&quot;last_run_at&quot;: null,
&quot;upcoming_runs_at&quot;: [&quot;2026-05-09T00:00:00Z&quot;, &quot;2026-05-16T00:00:00Z&quot;, &quot;2026-05-23T00:00:00Z&quot;]
}
}</code></pre>
<p><code>upcoming_runs_at</code> reflects the exact configured schedule, but <strong>execution is jittered to distribute load: up to 15% of the interval between runs, floored at 5 seconds and capped at 9 minutes.</strong> An hourly deployment can therefore fire up to 9 minutes late; don&#x27;t build a downstream deadline that assumes the listed timestamp. Maximum <strong>1000 scheduled deployments per organization</strong> (contact Anthropic support for more).</p>
<h3>Cron and timezone semantics</h3>
<ul><li><strong>Expression:</strong> standard POSIX cron (<code>minute hour day-of-month month day-of-week</code>).</li><li><strong>Timezone:</strong> IANA identifier (e.g. <code>&quot;America/Los_Angeles&quot;</code>).</li><li><strong>DST:</strong> literal wall-clock matching — <code>&quot;0 20 <em> </em> *&quot;</code> in <code>America/New_York</code> fires at 8:00 PM local regardless of EST/EDT.</li></ul>
<blockquote><p>⚠️ <strong>DST edge:</strong> wall-clock times that don&#x27;t exist on a spring-forward day (e.g. 2AM) are <strong>skipped</strong>; times that occur twice on a fall-back day <strong>fire twice</strong>. Schedule outside the 1–3AM local window, or use UTC, when missed or duplicate executions are unacceptable.</p></blockquote>
<h2>Deployment budgets</h2>
<p>A deployment accepts the same <code>budget</code> object as a session (<code>{type: &quot;limit&quot;, max_list_cost: {amount, currency}}</code> — minor-unit cents string, <code>USD</code> only; see <code>shared/managed-agents-core.md</code> § Session budgets). The cap is <strong>copied onto each session at fire time</strong>, and that session then behaves exactly like any budgeted session.</p>
<p>Deployment budget update semantics differ from a session&#x27;s:</p>
<ul><li><code>budget</code> is accepted on <strong>create and update</strong> — it is not create-only.</li><li><code>budget: null</code> on update <strong>clears</strong> it, and a cleared budget <strong>can be re-added later</strong> — there is no one-way door.</li><li>A change applies <strong>from the next fired session</strong> — sessions already running keep the cap they were created with (change those via their own session update).</li></ul>
<h2>Deployment runs</h2>
<p>Every trigger attempt — successful or not — writes a <strong>deployment run</strong> record (<code>drun_</code> prefix), so you can audit failures independent of the session lifecycle. A successful run carries the created <code>session_id</code>; follow that session via the event stream (<code>shared/managed-agents-events.md</code>) or webhooks (<code>shared/managed-agents-webhooks.md</code>) as usual. A failed run carries an <code>error</code> whose <code>type</code> explains why session creation was rejected.</p>
<pre><code class="lang-python"># All runs for a deployment
for run in client.beta.deployment_runs.list(deployment_id=deployment.id):
print(run.created_at, run.session_id or run.error.type)
# Failures only
for run in client.beta.deployment_runs.list(deployment_id=deployment.id, has_error=True):
print(run.created_at, run.error.type, run.error.message)</code></pre>
<pre><code class="lang-typescript">for await (const run of client.beta.deploymentRuns.list({
deployment_id: deployment.id,
has_error: true,
})) {
console.log(run.created_at, run.error?.type, run.error?.message);
}</code></pre>
<p>Raw HTTP: <code>GET /v1/deployment_runs?deployment_id=...&amp;has_error=true</code>. To retrieve a single run by ID, <code>GET /v1/deployment_runs/{deployment_run_id}</code> (SDK: <code>client.beta.deployment_runs.retrieve(run_id)</code>) — a <code>deployment_run.*</code> webhook event carries the run ID as its <code>data.id</code>.</p>
<p>A failed run looks like:</p>
<pre><code class="lang-json">{
&quot;type&quot;: &quot;deployment_run&quot;,
&quot;id&quot;: &quot;drun_01abc124&quot;,
&quot;deployment_id&quot;: &quot;depl_01xyz&quot;,
&quot;trigger_context&quot;: { &quot;type&quot;: &quot;schedule&quot;, &quot;scheduled_at&quot;: &quot;2026-05-09T00:00:00Z&quot; },
&quot;session_id&quot;: null,
&quot;error&quot;: { &quot;type&quot;: &quot;environment_archived&quot;, &quot;message&quot;: &quot;environment `env_01abc` is archived&quot; },
&quot;agent&quot;: { &quot;type&quot;: &quot;agent&quot;, &quot;id&quot;: &quot;agent_01ghi789&quot;, &quot;version&quot;: 3 },
&quot;created_at&quot;: &quot;2026-05-09T00:00:01Z&quot;
}</code></pre>
<p>Error types include <code>environment_archived</code>, <code>agent_archived</code>, <code>vault_not_found</code>, <code>session_rate_limited</code>, and <code>service_unavailable</code>.</p>
<p>The outcome of each <strong>scheduled</strong> run (started/succeeded/failed) and each deployment lifecycle change (created/updated/paused/unpaused/archived/deleted) is also delivered as a webhook event — see <code>shared/managed-agents-webhooks.md</code> for the <code>deployment.<em></code> and <code>deployment_run.</em></code> event types — so you can react without polling. Manual runs do <strong>not</strong> emit <code>deployment_run.*</code> webhook events.</p>
<h2>Lifecycle: pause / unpause / archive</h2>
<p>| Operation | SDK | Effect | |---|---|---| | Pause | <code>client.beta.deployments.pause(id)</code> | Suppresses scheduled triggers go-forward. Sessions already running continue. <strong>Manual runs are still permitted while paused.</strong> Sets <code>paused_reason: {&quot;type&quot;: &quot;manual&quot;}</code>. | | Unpause | <code>client.beta.deployments.unpause(id)</code> | Resumes from the next scheduled occurrence. <strong>Missed triggers are not backfilled.</strong> Clears <code>paused_reason</code>. | | Archive | <code>client.beta.deployments.archive(id)</code> | <strong>Terminal</strong> — the schedule stops and the deployment can no longer be modified. Use pause for anything reversible. |</p>
<p>Raw HTTP: <code>POST /v1/deployments/{deployment_id}/pause</code> (likewise <code>/unpause</code>, <code>/archive</code>).</p>
<h3>Failure behavior</h3>
<ul><li><strong>Rate-limited:</strong> recorded immediately as a <code>session_rate_limited</code> run, <strong>no retry</strong> — the schedule simply tries again at the next occurrence. (Rate limits on API calls <em>inside</em> a session are handled by the session itself.)</li><li><strong>Other failed runs</strong> (e.g. <code>environment_archived</code>, <code>vault_not_found</code>, <code>service_unavailable</code>): the run records the <code>error.type</code> — monitor runs and fix the referenced resource, or pause the deployment.</li><li><strong>Agent archived:</strong> the deployment is automatically <strong>archived</strong> (terminal) in the same operation. <strong>Agent deleted:</strong> the next scheduled trigger detects the missing agent and archives the deployment then. Either way no deployment run is recorded, and no further sessions are created.</li></ul>
<h2>Manual runs</h2>
<p><code>POST /v1/deployments/{deployment_id}/run</code> (SDK: <code>client.beta.deployments.run(id)</code>) creates a session immediately and writes a run with <code>trigger_context.type: &quot;manual&quot;</code>. Use it to <strong>test a deployment before committing to the schedule</strong> — and remember it works even while the deployment is paused.</p>
<footer>
<div class="fmap">
<div><b>Build</b>
<a href="https://hanzo.app">hanzo.app</a> app builder
<a href="https://hanzo.codes">hanzo.codes</a> code with an agent
<a href="https://hanzoskills.com">hanzoskills.com</a> what an agent reads</div>
<div><b>Run</b>
<a href="https://console.hanzo.ai">console.hanzo.ai</a> cloud console
<a href="https://api.hanzo.ai">api.hanzo.ai</a> the API</div>
<div><b>Account</b>
<a href="https://hanzo.id">hanzo.id</a> sign in
<a href="https://pay.hanzo.ai">pay.hanzo.ai</a> top up
<a href="https://billing.hanzo.ai">billing.hanzo.ai</a> invoices and usage</div>
<div><b>Company</b>
<a href="https://hanzo.ai">hanzo.ai</a> canonical
<a href="https://hanzo.ventures">hanzo.ventures</a> ventures</div>
</div>
<div class="fend"><a href="/managed-agents-scheduled-deployments.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
</footer>
</div></body></html>