Files
skills/public/hanzo-api.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

265 lines
19 KiB
HTML

<!doctype html>
<html lang="en"><head>
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
<title>hanzo-api</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="/hanzo-api.md">
<link rel="icon" href="/favicon.svg">
<link rel="canonical" href="https://hanzoskills.com/hanzo-api">
</head>
<!-- Reading this with a machine? Every page here is also plain markdown.
This one: https://hanzoskills.com/hanzo-api.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>hanzo-api</h1><p class="lede">Automatically discover how to CALL Hanzo&#x27;s own products over api.hanzo.ai — models, agents, sandboxes, secrets, billing, deployments, identity, telemetry. Activates when a task needs a Hanzo API rather than code written from scratch: o11y, ai, commerce, iam, git, project, admin, integration, agent, platform, marketing, visor, pricing, cloudflare, captable, provisioning, book, company, deploy, task, crm, team, framework, guide, tool, sandbox, automation, ingress.</p><h1>Hanzo API Skills Discovery</h1>
<p>Provides automatic access to 121 product skills covering 2492 operations on <code>api.hanzo.ai</code>, generated from the document the API serves.</p>
<h2>When This Skill Activates</h2>
<p>This skill auto-activates when you&#x27;re working with:</p>
<ul><li>Calling a Hanzo product instead of building the capability yourself</li><li><code>api.hanzo.ai</code>, <code>/v1/...</code> paths, or a <code>hanzo</code> CLI command</li><li>Authenticating to Hanzo (<code>hanzo auth token</code>, IAM bearer tokens)</li><li>Choosing which Hanzo product owns a capability you need</li></ul>
<h2>Available Skills</h2>
<h3>By Domain</h3>
<p><strong>Models and inference</strong> — <code>ai</code>, <code>eval</code>, <code>benchmark</code>, <code>research</code>, <code>experiment</code>, <code>ml</code>, <code>prompt</code>, <code>engine</code>, <code>translate</code></p>
<p><strong>Agents, code and workflow</strong> — <code>agent</code>, <code>task</code>, <code>tool</code>, <code>sandbox</code>, <code>automation</code>, <code>auto</code>, <code>bot</code>, <code>flow</code>, <code>code</code>, <code>marketplace</code>, <code>lsp</code>, <code>exec</code>, <code>node</code>, <code>skill</code></p>
<p><strong>Retrieval</strong> — <code>index</code>, <code>knowledge</code>, <code>websearch</code>, <code>world</code>, <code>product</code>, <code>ask</code>, <code>crawl</code>, <code>search</code></p>
<p><strong>Identity and access</strong> — <code>iam</code>, <code>admin</code>, <code>account</code>, <code>plugin</code>, <code>authz</code>, <code>entitlement</code>, <code>pref</code>, <code>setting</code></p>
<p><strong>Secrets and assurance</strong> — <code>wallet</code>, <code>kms</code>, <code>security</code>, <code>sbom</code>, <code>audit</code></p>
<p><strong>Money</strong> — <code>commerce</code>, <code>pricing</code>, <code>book</code>, <code>affiliate</code>, <code>plan</code>, <code>author</code>, <code>licensing</code>, <code>billing</code>, <code>treasury</code>, <code>leaderboard</code>, <code>usage</code>, <code>referral</code>, <code>allowance</code>, <code>x402</code></p>
<p><strong>Compute and data plumbing</strong> — <code>visor</code>, <code>provisioning</code>, <code>pubsub</code>, <code>mq</code>, <code>storage</code>, <code>registry</code>, <code>sync</code>, <code>venue</code></p>
<p><strong>Shipping and the edge</strong> — <code>git</code>, <code>project</code>, <code>platform</code>, <code>cloudflare</code>, <code>deploy</code>, <code>ingress</code>, <code>function</code>, <code>domain</code>, <code>dns</code>, <code>template</code>, <code>zt</code>, <code>blueprint</code>, <code>gateway</code>, <code>share</code>, <code>base</code>, <code>catalog</code></p>
<p><strong>Telemetry</strong> — <code>o11y</code>, <code>analytics</code>, <code>metric</code>, <code>destination</code></p>
<p><strong>Reaching people</strong> — <code>integration</code>, <code>marketing</code>, <code>crm</code>, <code>meet</code>, <code>social</code>, <code>campaign</code>, <code>link</code>, <code>tel</code>, <code>webhook</code>, <code>ad</code>, <code>channel</code>, <code>content</code>, <code>help</code>, <code>notify</code></p>
<p><strong>Running a company</strong> — <code>captable</code>, <code>company</code>, <code>team</code>, <code>framework</code>, <code>guide</code>, <code>compliance</code>, <code>dataroom</code>, <code>esign</code>, <code>todo</code>, <code>legal</code>, <code>risk</code>, <code>flag</code>, <code>dataset</code>, <code>label</code>, <code>reference</code>, <code>taxonomy</code>, <code>admission</code></p>
<p><strong>Chain</strong> — <code>web3</code>, <code>validator</code>, <code>explorer</code></p>
<p><strong>The document itself</strong> — <code>openapi</code></p>
<h3>Load Full Category Details</h3>
<pre><code class="lang-bash">cat skills/hanzo-api/INDEX.md</code></pre>
<h3>Load Specific Skills</h3>
<pre><code class="lang-bash">cat skills/hanzo-api/o11y.md
cat skills/hanzo-api/ai.md
cat skills/hanzo-api/commerce.md
cat skills/hanzo-api/iam.md
cat skills/hanzo-api/git.md
cat skills/hanzo-api/project.md</code></pre>
<h2>Authentication</h2>
<p>Every operation takes a Hanzo IAM bearer token. <code>hanzo auth token</code> prints the active short-lived access token for the identity you are signed in as; the org is carried in the token&#x27;s claim, never in a path or a query parameter.</p>
<pre><code class="lang-bash">TOKEN=$(hanzo auth token)
curl -sS https://api.hanzo.ai/v1/... -H &quot;Authorization: Bearer $TOKEN&quot;</code></pre>
<p>The document declares one scheme, <code>bearer</code>, at the top level: <code>Authorization: Bearer &lt;token&gt;</code>. <code>X-Authorization</code> and HTTP Basic carrying the token as the password are accepted spellings of the same header; a browser presents the session cookie instead. There is no product-specific key scheme.</p>
<h2>Skill Selection Guide</h2>
<p><strong>Do not write it — check whether Hanzo serves it.</strong> The surface is wider than most callers expect: incorporation, cap tables, DNS, e-signature, telephony and double-entry accounting are products here, not just models and storage.</p>
<p><strong>Find the owner of a capability</strong> without loading anything:</p>
<pre><code class="lang-bash">curl -sS https://api.hanzo.ai/v1/openapi.json \
| jq -r &#x27;.paths | to_entries[] | .key as $p | .value | to_entries[] | &quot;\(.value[&quot;x-app&quot;])\t\($p)\t\(.value.summary)&quot;&#x27; \
| grep -i &#x27;&lt;what you need&gt;&#x27;</code></pre>
<h2>Integration with Other Skills</h2>
<ul><li><code>hanzo</code> — what each Hanzo repo IS and how it is operated; this gateway is how to CALL it</li><li><code>hanzo-cloud-architecture/SKILL.md</code> — one binary, ZAP transport, why every product answers on one host</li><li><code>api</code> — designing your own API; this one consumes ours</li></ul>
<h2>Progressive Loading</h2>
<ul><li><strong>Level 1</strong>: This gateway (~200 lines)</li><li><strong>Level 2</strong>: <code>skills/hanzo-api/INDEX.md</code> — all 121 products by domain</li><li><strong>Level 3</strong>: <code>skills/hanzo-api/&lt;product&gt;.md</code> — one product&#x27;s whole surface</li><li><strong>Level 4</strong>: <code>https://api.hanzo.ai/v1/openapi.json</code> — the served document, always current</li></ul>
<hr>
<p><strong>Next Steps</strong>: Run <code>cat skills/hanzo-api/INDEX.md</code> to see every product, or load a product skill directly.</p>
<p><strong>Last Updated</strong>: 2026-08-20</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="/hanzo-api.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
</footer>
</div></body></html>