yards.list模块 44平台模块
平台模块Registered yards
查看登记在此工作区的每个持久的受管 Yard，每个都有自己的章程和配备人员的岗位。
yards.list 读取您的智能体集群实际运行所在的 Yard，它们在独立平台 Yards 中构建和运行。每个 Yard 在创建时就有自己的 ID、场地、规则包和七个标准岗位，其他路由可以分叉、迁移、修订或拆除 Yard。
yards.list模块 44查看登记在此工作区的每个持久的受管 Yard，每个都有自己的章程和配备人员的岗位。
yards.list 读取您的智能体集群实际运行所在的 Yard，它们在独立平台 Yards 中构建和运行。每个 Yard 在创建时就有自己的 ID、场地、规则包和七个标准岗位，其他路由可以分叉、迁移、修订或拆除 Yard。
idcreate 时分配。titlepackIdvenuecreate 用 title、packId 和 venue 记录一个 Yard，并安排 participantDids 中指名的智能体集群。
点击运行，将左侧的请求发送到共享演示工作区。
在共享的演示工作区中使用演示密钥运行：任何人都可以看到其中的内容，因此请勿发送任何私密信息。
一个符合 API 接受格式的请求，以及模块返回格式的示例响应。
GET /api/v1/acp/yards/list Authorization: Bearer av_workspace_•••• → 200 { yards }
运维人员读取 yards.list，查看智能体集群今天实际运行所在的每个 Yard，而不是应当存在什么的规划。
在有人批准或某个范围放行之前，plan 会显示清单变更将产生的确切差异及其摘要。
分叉默认抽取源 Yard 四分之一的数据并隐藏参与者 DID，因此可以在不触及生产环境及其人员的情况下试验有风险的变更。
模块是对一件狭窄事情的强力保证。请仅在其确切范围内依赖它。
yards.list 读取的 Yard 真实存在，具有真实的 ID、场地和规则包，不是规划或模板化的条目。*/**/all 永远不能被某个范围覆盖。岗位通过 role + yardId 寻址，绝不通过 DID，因此重新配备人员时，任何依赖它的东西都无需察觉或改变。
apply 的早期版本接受清单并直接持久化，完全没有差异、规划或审批检查。该漏洞已被堵上；现在每次应用都要经过 plan 或某个范围。
如果无法读取当前的清单包，apply 会以 503 拒绝，而不是把该组织视为没有任何现有的许可项。
使用工作区 API 密钥作为 Bearer 令牌进行认证。基础 URL 为 https://api.intramedial.com。
/api/v1/acp/yards/list列出此工作区登记的 Yard。/api/v1/acp/yards/get按 ID 读取一个 Yard。
local、cloud、wnam、weur、apac 或 oc；未知的场地会被拒绝，而不是作为自由文本接受。openparticipantDidsmigrationsfork创建时会调用 roles.charters 的配备例程，在其他任何事情发生之前，为新 Yard 配齐 yardmaster、steward、librarian、gatekeeper、clerk、auditor 和 treasurer。
plan 以带摘要的差异预览清单变更；apply 只有在获得匹配的人工审批或已获批准范围内的覆盖后才会生效，绝不会仅凭清单本身生效。
fork 基于源数据的抽样构建一个真实的 Yard，指定字段会被涂黑，并且可标记为临时，使其永远无法被提升回去。
migrate 为场地变更提交一个 Merkle 链式的连续性证明。它明确不会移动 Durable Object；那是平台范围的 rehoming.plan。
{
"yards": [
{
"id": "yard_8a1c",
"title": "payments-prod",
"packId": "pack_default",
"class": "yard",
"created_at": "2026-10-02T11:00:00.000Z",
"open": true,
"venue": "cloud",
"participantDids": [
"did:web:acme.example:agent:release"
]
}
]
}migrate 响应明确报告 movesDurableObjects: false，因此没有人会把场地记录的变更误当作实际的数据迁移。
import 一律返回 501；本模块只封装树内已有的东西。plan-merge 和 split-plan 是模拟，明确不会合并或拆分真实存储。mandates.compile 和 coordination.admit 的事；Yard 是工作发生的地方，而不是授权工作的依据。from 会被拒绝。migrate 移动记录的场地并提交证明；Durable Object 仍留在 rehoming.plan 放置的位置。plan-merge 或 split-plan 改变了任何东西。两者都将 wouldMergeDos/wouldSplitDos 报告为 false，不触及任何东西。mark-ephemeral 会使该分叉的提升被永久拒绝。import 始终返回 501；独立 Yards 的导入保持受限，直到其自身的契约文档被标记为就绪，无论存储状态如何。*、** 或 all 上的全面许可项；该下限不可被配置调低。list 和 get；创建、规划、应用、分叉、迁移和拆除目前都是仅限 REST 的运维操作。coordination.yards.list以 MCP 操作列出 Yard。coordination.yards.get以 MCP 操作读取一个 Yard。mandates.compile03