由 Techstack v0.32.8 版本生成（源码
4c7d219a5d56）。对于已安装的版本，请以 techstack api <command> --help 为准。techstack api stacks create
在所有者的 Homelab 中创建 StackKit 部署。 根据以stack_spec 提供的规范 StackKits stack-spec 负载，在经过认证的 B2C 所有者唯一的 Homelab 下创建一个内部 StackKit 部署。旧版 /stacks 路由和 stack_id 响应字段标识的就是该部署；它们不会创建或选择第二个 Homelab 产品。一个 TechStack 实例可以服务许多所有者，每个所有者都有自己的 Homelab。旧版 user_config/kombination 负载在此兼容边界上仍被接受。向导客户端应发送稳定的 X-Idempotency-Key；使用相同键和相同负载的重试会返回原始的部署、计划服务器和预配任务。
techstack api stacks deploy
对一个 StackKit 部署执行 rollout（unify + IaC + tofu apply）。techstack api stacks destroy
停用一个 StackKit 部署及其基础设施。techstack api stacks drift check
触发漂移检查。 速率限制为每 5 分钟一次（除非 force=true）techstack api stacks drift details
获取包含受影响资源的详细漂移信息。techstack api stacks drift resolve
触发漂移解决（重新应用）。 前提条件：栈的状态必须为 “drifted”techstack api stacks drift status
获取当前漂移状态。techstack api stacks export
将栈导出为 stack-spec.yaml。 根据 Accept 标头返回 YAML 或 JSON 格式的 StackKits stack-spectechstack api stacks import
将 stack-spec.yaml 导入为 StackKit 部署。 将 YAML 或 JSON 作为部署导入到经过认证的所有者的 Homelab 下。techstack api stacks intent
获取已持久化的 kombination.yaml（逐字节一致，base64）。techstack api stacks list
列出所有者的 StackKit 部署。 返回经过认证的所有者唯一的 B2C Homelab 下的所有 StackKit 部署。kit_deployment_id、homelab_id 和 stackkit_id 是产品身份；在使用方迁移期间，旧版标识符仍作为此路由上的兼容别名保留。
techstack api stacks managed-runtimes add
通过原生提供商控制添加一个托管节点。 为确切的自有 StackKit 部署创建或恢复一个确定性的 Add-Server 任务。标准的Idempotency-Key 是必需的。使用相同的键重放相同的规范请求，会返回原始的任务、租约、运行时服务器、资源代际和提供商操作关联；以不同的意图重用该键会以 409 失败。
原始键从不持久化或返回。丢失的响应或不确定的原生准入结果只能使用相同的键恢复。HTTP 接受表示原生准入已持久化且提供商协调尚待进行；它从不声称虚拟机已经预配完成或处于健康状态。新的准入会以原子方式，将经过认证的租户/所有者容量槽位与租约代际和提供商操作一同预留。当权威的原生准入发现该有界容量已满时，会持久化一个不可重试的 403 结果，重放该被拒绝的任务会返回相同的结果。对已提交准入的精确重放会复用其现有预留。此版本没有自动释放预留的机制：仅有终态或本地停用状态并不会释放槽位。租约清单和功能交付标志从不授予或拒绝容量。托管环境中的新准入还需要以 v2 签名的商业运行时和提供商权益，以及已签名的 cloud.runtime.credits managed_servers 模式/限额决策；仅有功能标志从不授予提供商容量。自托管 OSS 改用其在构建时固定的静态版本清单策略，而不依赖 SaaS 权益。
techstack api stacks operations
获取某个自有 StackKit 部署在配置完成后的运维读取模型。 返回 TechStack 运维仪表板所使用的、按所有者和租户限定的确切读取模型。approved_servers 记录运维人员的批准；connected_servers 更为严格，只统计已分配、已批准且具有带新鲜度限定的规范 Guard 心跳、连接和健康证据的节点。该操作是只读的，从不启动 rollout、预配或提供商工作。
techstack api stacks owner-spec
获取 StackKit 部署的所有者引导规格。 用于获取本地所有者字段和恢复口令哈希的 StackKit 管理员引导端点。此路由只接受由createStack 返回的短期引导 Bearer 令牌；它不使用常规的浏览器/会话 Bearer 令牌。
techstack api stacks pipeline-status
获取所有规格阶段的完整流水线状态。techstack api stacks provision
开始预配现有的 StackKit 部署。techstack api stacks prune-orphans
审查或应用按所有者限定的测试残留清理。 仅针对控制平面投影的两阶段清理。dry_run 会返回经过认证的所有者确切的 E2E/runtime-cloud 候选项，以及一个与修订绑定的稳定摘要。apply 会重新计算计划，并且只接受该确切摘要。此路由从不停用租约、调用提供商、销毁基础设施或将生命周期工作加入队列。
techstack api stacks requirements
获取需求规格（阶段 1 输出）。techstack api stacks resume-enrollment
在其确切的现有虚拟机上恢复一个逾期的托管节点等待。 对已持久化的、处于waiting_enrollment、waiting_provider_provision 或 waiting_canonical_guard 状态且其 next_resume_at 已超过有界宽限期的任务，进行经过认证的幂等恢复。服务器会将自有 StackKit 部署、源任务、等待原因、确切租约、活动的 foundation 角色和规范节点作为一个操作进行校验。它会以原子方式结束该确切的源等待，创建或重新激活一个绑定到同一租约和节点的确定性替代部署，并在后续调用中重放该任务。在进入处理程序之前，队列 Worker 会以原子方式获取持久的 tenant/stack 兼容执行声明；这会在各 Techstack 副本之间串行化同一 StackKit 部署的不同任务。该声明会持久保持 running，直到处理程序退出，包括取消期间。此端点从不调用提供商的虚拟机创建，也不会选择更新的虚拟机。崩溃后被发现处于持久 running 状态的替代任务会保持失败关闭，作为同一任务报告，并且从不自动复制；运行时操作的协调仍是独立的运维事项。
techstack api stacks retry-rollout
在其确切的现有托管虚拟机上重试一次失败的 StackKit 部署 rollout。 在一次服务器端操作中校验自有的失败部署、其确切的活动 foundation 租约和规范节点。确定性的持久替代任务会绕过提供商的虚拟机创建，在进入处理程序之前赢得持久的tenant/stack 兼容执行声明，并在重复调用此操作时被重放。该声明会在各副本之间串行化同一 StackKit 部署的不同任务，并在进程崩溃后以 running 保持失败关闭，直到运维人员进行协调。
techstack api stacks routing ensure
确保某个确切 StackKit 部署和节点具有期望的路由覆盖层。 以原子方式持久化一个幂等、带修订的路由覆盖层，而不修改用户的不可变意图。server_id 始终是确切且必需的。lease_id 对托管运行时是必需的，对没有租约的本地/Basement 运行时则省略。对于托管目标，ensure_rollout 为 true 的请求只有在证明其所选的活动 foundation 租约和规范节点与此确切目标一致之后，才会分派现有的部署流水线。API 从不将由此产生的任务报告为已应用。覆盖层只在推导 StackKits 产物时被使用，此路径从不创建或选择替代虚拟机。techstack api stacks routing get
读取某个 StackKit 部署期望的和已观测的路由状态。 返回确切 StackKit 部署的、与租户和所有者绑定的路由覆盖层。期望状态与已观测/已应用状态分开报告，因此客户端绝不会仅凭持久化就推断 DNS、TLS 或 StackKit rollout 已成功。techstack api stacks routing targets
列出某个 StackKit 部署的显式主路由目标。 由活动的 RuntimeLease 授权支持的只读发现。返回所有对所有者可见的 foundation/control-plane 目标，从不选择其中之一、创建规范节点（ServerRuntime）投影或修改 StackKit 部署。调用方必须将完整的 server_id 和 lease_id 元组发送给路由变更操作。