`admin` 操作
本页由机器从英文原文翻译,内容以英文原文为准。 Machine-translated from the English page, which is authoritative.
每个 admin.* 操作所接受和返回的确切字段。
每个操作都是通过 HTTP 的 POST /v1/<op>,同时也是 MCP 工具 loom_<op>。身份字段(org、namespace、agent、user_id、session_id)会在传输层能够提供时,从令牌和 MCP 会话中填充;对于单用户服务器上不带令牌的 HTTP 调用,除 code.* 和 tracker.*(它们保留各自平面的 org)之外的所有操作都使用该安装的 org,而对于部分操作,其命名空间和 agent 也会被填充;参见身份与命名空间。操作索引说明了角色、类型以及 MCP 的 all 列表。未知的输入字段仍会被处理,并在 ignored_args 中列出。
admin.users
汇总来自 namespace_grants 和 namespaces.owner_email 的用户主体,结合审计日志中的最近活跃时间,并标记已配置的平台管理员。
POST /v1/admin.users · MCP loom_admin_users · 角色 org_admin · 幂等 · 不在 MCP all 工具集中列出
| 输入字段 | 类型 | 默认值 | 含义 |
|---|---|---|---|
org |
str |
必填 | 租户(身份元组的第一个元素)。 |
namespace |
str | None |
None |
该操作读取或写入的命名空间。 |
include_service_accounts |
bool |
False |
同时列出既没有联系邮箱也没有密码的主体(服务账号);关闭时,这些主体不会列出。 |
limit |
int |
200 |
最多返回这么多用户,按主体顺序排列;取值范围为 1 到 1,000。 |
| 输出字段 | 类型 | 含义 |
|---|---|---|
users |
list[UserSummary] |
按主体顺序排列的一页用户,每个用户附带其授权和所拥有的命名空间。 |
total |
int |
应用 limit 之前,符合过滤条件的用户数。 |
total_pending_elevations |
int |
本页中带有未批准提权请求的授权数。 |
total_active_last_7d |
int |
本页中在过去 7 天内有审计记录的用户数。 |
platform_admins_configured |
list[str] |
已配置的平台管理员身份,已排序;除非调用者是平台管理员(或未启用认证),否则为空。 |