Claude Platform Docs

Beta

Models
beta_api_error: object{ type: "api_error", message }
type: "api_error"
message: string
beta_authentication_error: object{ type: "authentication_error", message }
type: "authentication_error"
message: string
beta_billing_error: object{ type: "billing_error", message }
type: "billing_error"
message: string
beta_currency: "USD"
"USD"
beta_error_response: object{ type: "error", error, request_id }
beta_gateway_timeout_error: object{ type: "timeout_error", message }
type: "timeout_error"
message: string
beta_invalid_request_error: object{ type: "invalid_request_error", message }
type: "invalid_request_error"
message: string
beta_monetary_amount: object{ amount, currency }

A monetary amount in a specific currency.

amount: string

Amount in minor units of the currency, as an integer decimal string with no leading zeros: "2500" is $25.00 and "50" is fifty cents. A string rather than a number so no float rounding is ever applied.

currency: "USD"

Uppercase ISO-4217 currency code. USD is the only currency currently supported; the accepted set is closed and grows only when a new currency is priced.

beta_not_found_error: object{ type: "not_found_error", message }
type: "not_found_error"
message: string
beta_overloaded_error: object{ type: "overloaded_error", message }
type: "overloaded_error"
message: string
beta_permission_error: object{ type: "permission_error", message }
type: "permission_error"
message: string
beta_rate_limit_error: object{ type: "rate_limit_error", message }
type: "rate_limit_error"
message: string

Beta模型

列出模型
$ ant beta:models list
GET/v1/models

列出可用模型。

获取模型
$ ant beta:models retrieve
GET/v1/models/{model_id}

获取特定模型。

Beta消息

创建消息
$ ant beta:messages create
POST/v1/messages

发送包含文本和/或图像内容的结构化输入消息列表，模型将生成对话中的下一条消息。

计算消息中的令牌数
$ ant beta:messages count-tokens
POST/v1/messages/count_tokens

计算消息中的令牌数量。

Beta消息批处理

创建消息批次
$ ant beta:messages:batches create
POST/v1/messages/batches

发送一批消息创建请求。

检索消息批次
$ ant beta:messages:batches retrieve
GET/v1/messages/batches/{message_batch_id}

此端点是幂等的，可用于轮询消息批次是否完成。要访问消息批次的结果，请向响应中的 results_url 字段发起请求。

列出消息批次
$ ant beta:messages:batches list
GET/v1/messages/batches

列出工作区内的所有消息批次。最近创建的批次最先返回。

取消消息批次
$ ant beta:messages:batches cancel
POST/v1/messages/batches/{message_batch_id}/cancel

批次可在处理结束前的任何时间取消。一旦发起取消，批次将进入 canceling 状态，此时系统可能会先完成任何正在进行的、不可中断的请求，然后再最终完成取消。

删除消息批次
$ ant beta:messages:batches delete
DELETE/v1/messages/batches/{message_batch_id}

删除消息批次。

检索消息批次结果
$ ant beta:messages:batches results
GET/v1/messages/batches/{message_batch_id}/results

以 .jsonl 文件的形式流式传输消息批次的结果。

Beta代理

创建代理
$ ant beta:agents create
POST/v1/agents
列出代理
$ ant beta:agents list
GET/v1/agents
获取代理
$ ant beta:agents retrieve
GET/v1/agents/{agent_id}
更新代理
$ ant beta:agents update
POST/v1/agents/{agent_id}
归档代理
$ ant beta:agents archive
POST/v1/agents/{agent_id}/archive

Beta代理版本

列出代理版本
$ ant beta:agents:versions list
GET/v1/agents/{agent_id}/versions

Beta环境

创建环境
$ ant beta:environments create
POST/v1/environments

使用指定配置创建新环境。

列出环境
$ ant beta:environments list
GET/v1/environments

列出环境，支持分页。

获取环境
$ ant beta:environments retrieve
GET/v1/environments/{environment_id}

按 ID 检索特定环境。

更新环境
$ ant beta:environments update
POST/v1/environments/{environment_id}

更新现有环境的配置。

删除环境
$ ant beta:environments delete
DELETE/v1/environments/{environment_id}

按 ID 删除环境。返回删除确认。

归档环境
$ ant beta:environments archive
POST/v1/environments/{environment_id}/archive

按 ID 归档环境。已归档的环境不能用于创建新会话。

Beta环境工作

获取工作项
$ ant beta:environments:work retrieve
GET/v1/environments/{environment_id}/work/{work_id}

注意：这些端点由 SDK 和 CLI 中提供的预构建环境工作器自动调用，用于编排使用自托管沙箱环境的会话。此处列出仅供参考；您无需直接调用它们。

轮询工作
$ ant beta:environments:work poll
GET/v1/environments/{environment_id}/work/poll

注意：这些端点由 SDK 和 CLI 中提供的预构建环境工作器自动调用，用于编排使用自托管沙箱环境的会话。此处列出仅供参考；您无需直接调用它们。

确认工作
$ ant beta:environments:work ack
POST/v1/environments/{environment_id}/work/{work_id}/ack

注意：这些端点由 SDK 和 CLI 中提供的预构建环境工作器自动调用，用于编排使用自托管沙箱环境的会话。此处列出仅供参考；您无需直接调用它们。

记录心跳
$ ant beta:environments:work heartbeat
POST/v1/environments/{environment_id}/work/{work_id}/heartbeat

注意：这些端点由 SDK 和 CLI 中提供的预构建环境工作器自动调用，用于编排使用自托管沙箱环境的会话。此处列出仅供参考；您无需直接调用它们。

停止工作
$ ant beta:environments:work stop
POST/v1/environments/{environment_id}/work/{work_id}/stop

注意：这些端点由 SDK 和 CLI 中提供的预构建环境工作器自动调用，用于编排使用自托管沙箱环境的会话。此处列出仅供参考；您无需直接调用它们。

列出工作项
$ ant beta:environments:work list
GET/v1/environments/{environment_id}/work

注意：这些端点由 SDK 和 CLI 中提供的预构建环境工作器自动调用，用于编排使用自托管沙箱环境的会话。此处列出仅供参考；您无需直接调用它们。

更新工作项
$ ant beta:environments:work update
POST/v1/environments/{environment_id}/work/{work_id}

注意：这些端点由 SDK 和 CLI 中提供的预构建环境工作器自动调用，用于编排使用自托管沙箱环境的会话。此处列出仅供参考；您无需直接调用它们。

获取队列统计信息
$ ant beta:environments:work stats
GET/v1/environments/{environment_id}/work/stats

获取某个环境的工作队列统计信息。

Beta会话

创建会话
$ ant beta:sessions create
POST/v1/sessions
列出会话
$ ant beta:sessions list
GET/v1/sessions
获取会话
$ ant beta:sessions retrieve
GET/v1/sessions/{session_id}
更新会话
$ ant beta:sessions update
POST/v1/sessions/{session_id}
删除会话
$ ant beta:sessions delete
DELETE/v1/sessions/{session_id}
归档会话
$ ant beta:sessions archive
POST/v1/sessions/{session_id}/archive

Beta会话事件

列出事件
$ ant beta:sessions:events list
GET/v1/sessions/{session_id}/events
发送事件
$ ant beta:sessions:events send
POST/v1/sessions/{session_id}/events
流式传输事件
$ ant beta:sessions:events stream
GET/v1/sessions/{session_id}/events/stream

Beta会话资源

添加会话资源
$ ant beta:sessions:resources add
POST/v1/sessions/{session_id}/resources
列出会话资源
$ ant beta:sessions:resources list
GET/v1/sessions/{session_id}/resources
获取会话资源
$ ant beta:sessions:resources retrieve
GET/v1/sessions/{session_id}/resources/{resource_id}
更新会话资源
$ ant beta:sessions:resources update
POST/v1/sessions/{session_id}/resources/{resource_id}
删除会话资源
$ ant beta:sessions:resources delete
DELETE/v1/sessions/{session_id}/resources/{resource_id}

Beta会话线程

列出会话线程
$ ant beta:sessions:threads list
GET/v1/sessions/{session_id}/threads
获取会话线程
$ ant beta:sessions:threads retrieve
GET/v1/sessions/{session_id}/threads/{thread_id}
归档会话线程
$ ant beta:sessions:threads archive
POST/v1/sessions/{session_id}/threads/{thread_id}/archive

Beta会话线程事件

列出会话线程事件
$ ant beta:sessions:threads:events list
GET/v1/sessions/{session_id}/threads/{thread_id}/events
流式传输会话线程事件
$ ant beta:sessions:threads:events stream
GET/v1/sessions/{session_id}/threads/{thread_id}/stream

Beta部署

创建部署
$ ant beta:deployments create
POST/v1/deployments
列出部署
$ ant beta:deployments list
GET/v1/deployments
获取部署
$ ant beta:deployments retrieve
GET/v1/deployments/{deployment_id}
更新部署
$ ant beta:deployments update
POST/v1/deployments/{deployment_id}
归档部署
$ ant beta:deployments archive
POST/v1/deployments/{deployment_id}/archive
立即运行部署
$ ant beta:deployments run
POST/v1/deployments/{deployment_id}/run
暂停部署
$ ant beta:deployments pause
POST/v1/deployments/{deployment_id}/pause
取消暂停部署
$ ant beta:deployments unpause
POST/v1/deployments/{deployment_id}/unpause

Beta部署运行

列出部署运行
$ ant beta:deployment-runs list
GET/v1/deployment_runs
获取部署运行
$ ant beta:deployment-runs retrieve
GET/v1/deployment_runs/{deployment_run_id}

Beta保管库

创建保管库
$ ant beta:vaults create
POST/v1/vaults
列出保管库
$ ant beta:vaults list
GET/v1/vaults
检索保管库
$ ant beta:vaults retrieve
GET/v1/vaults/{vault_id}
更新保管库
$ ant beta:vaults update
POST/v1/vaults/{vault_id}
删除保管库
$ ant beta:vaults delete
DELETE/v1/vaults/{vault_id}
归档保管库
$ ant beta:vaults archive
POST/v1/vaults/{vault_id}/archive

Beta保管库凭证

创建凭证
$ ant beta:vaults:credentials create
POST/v1/vaults/{vault_id}/credentials
列出凭证
$ ant beta:vaults:credentials list
GET/v1/vaults/{vault_id}/credentials
检索凭证
$ ant beta:vaults:credentials retrieve
GET/v1/vaults/{vault_id}/credentials/{credential_id}
更新凭证
$ ant beta:vaults:credentials update
POST/v1/vaults/{vault_id}/credentials/{credential_id}
删除凭证
$ ant beta:vaults:credentials delete
DELETE/v1/vaults/{vault_id}/credentials/{credential_id}
归档凭证
$ ant beta:vaults:credentials archive
POST/v1/vaults/{vault_id}/credentials/{credential_id}/archive
验证 MCP OAuth 凭证
$ ant beta:vaults:credentials mcp-oauth-validate
POST/v1/vaults/{vault_id}/credentials/{credential_id}/mcp_oauth_validate

Beta记忆存储

创建记忆存储
$ ant beta:memory-stores create
POST/v1/memory_stores
列出记忆存储
$ ant beta:memory-stores list
GET/v1/memory_stores
检索记忆存储
$ ant beta:memory-stores retrieve
GET/v1/memory_stores/{memory_store_id}
更新记忆存储
$ ant beta:memory-stores update
POST/v1/memory_stores/{memory_store_id}
删除记忆存储
$ ant beta:memory-stores delete
DELETE/v1/memory_stores/{memory_store_id}
归档记忆存储
$ ant beta:memory-stores archive
POST/v1/memory_stores/{memory_store_id}/archive

Beta记忆存储记忆

创建记忆
$ ant beta:memory-stores:memories create
POST/v1/memory_stores/{memory_store_id}/memories
列出记忆
$ ant beta:memory-stores:memories list
GET/v1/memory_stores/{memory_store_id}/memories
检索记忆
$ ant beta:memory-stores:memories retrieve
GET/v1/memory_stores/{memory_store_id}/memories/{memory_id}
更新记忆
$ ant beta:memory-stores:memories update
POST/v1/memory_stores/{memory_store_id}/memories/{memory_id}
删除记忆
$ ant beta:memory-stores:memories delete
DELETE/v1/memory_stores/{memory_store_id}/memories/{memory_id}

Beta记忆存储记忆版本

列出记忆版本
$ ant beta:memory-stores:memory-versions list
GET/v1/memory_stores/{memory_store_id}/memory_versions
检索记忆版本
$ ant beta:memory-stores:memory-versions retrieve
GET/v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id}
对记忆版本进行脱敏
$ ant beta:memory-stores:memory-versions redact
POST/v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id}/redact

Beta文件

上传文件
$ ant beta:files upload
POST/v1/files
列出文件
$ ant beta:files list
GET/v1/files
下载文件
$ ant beta:files download
GET/v1/files/{file_id}/content
获取文件元数据
$ ant beta:files retrieve-metadata
GET/v1/files/{file_id}
删除文件
$ ant beta:files delete
DELETE/v1/files/{file_id}

Beta技能

创建技能
$ ant beta:skills create
POST/v1/skills
列出技能
$ ant beta:skills list
GET/v1/skills
获取技能
$ ant beta:skills retrieve
GET/v1/skills/{skill_id}
删除技能
$ ant beta:skills delete
DELETE/v1/skills/{skill_id}

Beta技能版本

创建技能版本
$ ant beta:skills:versions create
POST/v1/skills/{skill_id}/versions
列出技能版本
$ ant beta:skills:versions list
GET/v1/skills/{skill_id}/versions
下载技能版本内容
$ ant beta:skills:versions download
GET/v1/skills/{skill_id}/versions/{version}/content

以 zip 压缩包形式下载技能版本的内容。

获取技能版本
$ ant beta:skills:versions retrieve
GET/v1/skills/{skill_id}/versions/{version}
删除技能版本
$ ant beta:skills:versions delete
DELETE/v1/skills/{skill_id}/versions/{version}

Beta用户配置文件

创建用户配置文件
$ ant beta:user-profiles create
POST/v1/user_profiles
列出用户配置文件
$ ant beta:user-profiles list
GET/v1/user_profiles
获取用户配置文件
$ ant beta:user-profiles retrieve
GET/v1/user_profiles/{user_profile_id}
更新用户配置文件
$ ant beta:user-profiles update
POST/v1/user_profiles/{user_profile_id}
删除用户配置文件
$ ant beta:user-profiles delete
DELETE/v1/user_profiles/{user_profile_id}
创建注册 URL
$ ant beta:user-profiles create-enrollment-url
POST/v1/user_profiles/{user_profile_id}/enrollment_url

Beta用户配置文件操作 URL

创建操作 URL
$ ant beta:user-profiles:action-urls create
POST/v1/user_profiles/{user_profile_id}/action_urls

BetaDream

创建 Dream
$ ant beta:dreams create
POST/v1/dreams

启动一个异步作业，该作业使用过去的会话生成记忆存储的重组版本，并返回 dream 以供您轮询结果。

列出 Dream
$ ant beta:dreams list
GET/v1/dreams

按从新到旧的顺序列出工作区中的 dream。

获取 Dream
$ ant beta:dreams retrieve
GET/v1/dreams/{dream_id}

通过 ID 获取 dream，以检查其状态、输出记忆存储和令牌用量。

取消 Dream
$ ant beta:dreams cancel
POST/v1/dreams/{dream_id}/cancel

停止处于 pending 或 running 状态的 dream。

归档 Dream
$ ant beta:dreams archive
POST/v1/dreams/{dream_id}/archive

将处于 completed、failed 或 canceled 状态的 dream 从默认 dream 列表中隐藏。

Beta隧道

创建隧道
$ ant beta:tunnels create
POST/v1/tunnels

Tunnels API 目前处于研究预览阶段。它需要 anthropic-beta: mcp-tunnels-2026-06-22 请求头，并且可能在没有弃用期的情况下发生变更。它取代了位于 /v1/organizations/tunnels 的 Admin API 端点，这些端点在迁移窗口期内仍然可用。

获取隧道
$ ant beta:tunnels retrieve
GET/v1/tunnels/{tunnel_id}

Tunnels API 目前处于研究预览阶段。它需要 anthropic-beta: mcp-tunnels-2026-06-22 请求头，并且可能在没有弃用期的情况下发生变更。它取代了位于 /v1/organizations/tunnels 的 Admin API 端点，这些端点在迁移窗口期内仍然可用。

列出隧道
$ ant beta:tunnels list
GET/v1/tunnels

Tunnels API 目前处于研究预览阶段。它需要 anthropic-beta: mcp-tunnels-2026-06-22 请求头，并且可能在没有弃用期的情况下发生变更。它取代了位于 /v1/organizations/tunnels 的 Admin API 端点，这些端点在迁移窗口期内仍然可用。

归档隧道
$ ant beta:tunnels archive
POST/v1/tunnels/{tunnel_id}/archive

Tunnels API 目前处于研究预览阶段。它需要 anthropic-beta: mcp-tunnels-2026-06-22 请求头，并且可能在没有弃用期的情况下发生变更。它取代了位于 /v1/organizations/tunnels 的 Admin API 端点，这些端点在迁移窗口期内仍然可用。

显示隧道令牌
$ ant beta:tunnels reveal-token
POST/v1/tunnels/{tunnel_id}/reveal_token

Tunnels API 目前处于研究预览阶段。它需要 anthropic-beta: mcp-tunnels-2026-06-22 请求头，并且可能在没有弃用期的情况下发生变更。它取代了位于 /v1/organizations/tunnels 的 Admin API 端点，这些端点在迁移窗口期内仍然可用。

轮换隧道令牌
$ ant beta:tunnels rotate-token
POST/v1/tunnels/{tunnel_id}/rotate_token

Tunnels API 目前处于研究预览阶段。它需要 anthropic-beta: mcp-tunnels-2026-06-22 请求头，并且可能在没有弃用期的情况下发生变更。它取代了位于 /v1/organizations/tunnels 的 Admin API 端点，这些端点在迁移窗口期内仍然可用。

Beta隧道证书

创建隧道证书
$ ant beta:tunnels:certificates create
POST/v1/tunnels/{tunnel_id}/certificates

Tunnels API 目前处于研究预览阶段。它需要 anthropic-beta: mcp-tunnels-2026-06-22 请求头，并且可能在没有弃用期的情况下发生变更。它取代了位于 /v1/organizations/tunnels 的 Admin API 端点，这些端点在迁移窗口期内仍然可用。

获取隧道证书
$ ant beta:tunnels:certificates retrieve
GET/v1/tunnels/{tunnel_id}/certificates/{certificate_id}

Tunnels API 目前处于研究预览阶段。它需要 anthropic-beta: mcp-tunnels-2026-06-22 请求头，并且可能在没有弃用期的情况下发生变更。它取代了位于 /v1/organizations/tunnels 的 Admin API 端点，这些端点在迁移窗口期内仍然可用。

列出隧道证书
$ ant beta:tunnels:certificates list
GET/v1/tunnels/{tunnel_id}/certificates

Tunnels API 目前处于研究预览阶段。它需要 anthropic-beta: mcp-tunnels-2026-06-22 请求头，并且可能在没有弃用期的情况下发生变更。它取代了位于 /v1/organizations/tunnels 的 Admin API 端点，这些端点在迁移窗口期内仍然可用。

归档隧道证书
$ ant beta:tunnels:certificates archive
POST/v1/tunnels/{tunnel_id}/certificates/{certificate_id}/archive

Tunnels API 目前处于研究预览阶段。它需要 anthropic-beta: mcp-tunnels-2026-06-22 请求头，并且可能在没有弃用期的情况下发生变更。它取代了位于 /v1/organizations/tunnels 的 Admin API 端点，这些端点在迁移窗口期内仍然可用。

Beta组织

获取当前组织
$ ant beta:organization retrieve
GET/v1/organizations/me

检索与经过身份验证的 API 密钥关联的组织的信息。

Beta组织API 密钥

列出 API 密钥
$ ant beta:organization:api-keys list
GET/v1/organizations/api_keys
检索 API 密钥（Admin API）
$ ant beta:organization:api-keys retrieve
GET/v1/organizations/api_keys/{api_key_id}

按 ID 检索您组织中单个 API 密钥的信息。此 Admin API 端点需要 Admin API 密钥，用于以编程方式管理密钥，并且绝不会返回密钥的机密值。要查看或创建您自己的 API 密钥，请前往 Claude Console 中的 API 密钥页面。

更新 API 密钥
$ ant beta:organization:api-keys update
POST/v1/organizations/api_keys/{api_key_id}

Beta组织外部密钥

创建外部密钥
$ ant beta:organization:external-keys create
POST/v1/organizations/external_keys

创建一个归调用方组织所有的外部密钥配置。

列出外部密钥
$ ant beta:organization:external-keys list
GET/v1/organizations/external_keys

列出调用方组织中的外部密钥配置。

获取外部密钥
$ ant beta:organization:external-keys retrieve
GET/v1/organizations/external_keys/{external_key_id}

按 ID 检索调用方组织中的单个外部密钥配置。

更新外部密钥
$ ant beta:organization:external-keys update
POST/v1/organizations/external_keys/{external_key_id}

部分更新外部密钥配置。省略的字段保持不变。

删除外部密钥
$ ant beta:organization:external-keys delete
DELETE/v1/organizations/external_keys/{external_key_id}

删除外部密钥配置。

验证外部密钥
$ ant beta:organization:external-keys validate
POST/v1/organizations/external_keys/{external_key_id}/validate

针对客户的 KMS 验证外部密钥配置。

Beta组织联合颁发者

创建联合颁发者
$ ant beta:organization:federation:issuers create
POST/v1/organizations/federation_issuers

需要具有 org:admin 作用域的 OAuth 访问令牌，可通过 ant auth login --scope org:admin 或工作负载身份联合规则获取；不接受 Admin API 密钥。请参阅使用 Admin API 管理 WIF。

列出联合颁发者
$ ant beta:organization:federation:issuers list
GET/v1/organizations/federation_issuers

需要具有 org:admin 作用域的 OAuth 访问令牌，可通过 ant auth login --scope org:admin 或工作负载身份联合规则获取；不接受 Admin API 密钥。请参阅使用 Admin API 管理 WIF。

获取联合颁发者
$ ant beta:organization:federation:issuers retrieve
GET/v1/organizations/federation_issuers/{federation_issuer_id}

需要具有 org:admin 作用域的 OAuth 访问令牌，可通过 ant auth login --scope org:admin 或工作负载身份联合规则获取；不接受 Admin API 密钥。请参阅使用 Admin API 管理 WIF。

更新联合颁发者
$ ant beta:organization:federation:issuers update
POST/v1/organizations/federation_issuers/{federation_issuer_id}

需要具有 org:admin 作用域的 OAuth 访问令牌，可通过 ant auth login --scope org:admin 或工作负载身份联合规则获取；不接受 Admin API 密钥。请参阅使用 Admin API 管理 WIF。

归档联合颁发者
$ ant beta:organization:federation:issuers archive
POST/v1/organizations/federation_issuers/{federation_issuer_id}/archive

需要具有 org:admin 作用域的 OAuth 访问令牌，可通过 ant auth login --scope org:admin 或工作负载身份联合规则获取；不接受 Admin API 密钥。请参阅使用 Admin API 管理 WIF。

Beta组织联合规则

创建联合规则
$ ant beta:organization:federation:rules create
POST/v1/organizations/federation_rules

需要具有 org:admin 作用域的 OAuth 访问令牌，可通过 ant auth login --scope org:admin 或工作负载身份联合规则获取；不接受 Admin API 密钥。请参阅使用 Admin API 管理 WIF。

列出联合规则
$ ant beta:organization:federation:rules list
GET/v1/organizations/federation_rules

需要具有 org:admin 作用域的 OAuth 访问令牌，可通过 ant auth login --scope org:admin 或工作负载身份联合规则获取；不接受 Admin API 密钥。请参阅使用 Admin API 管理 WIF。

获取联合规则
$ ant beta:organization:federation:rules retrieve
GET/v1/organizations/federation_rules/{federation_rule_id}

需要具有 org:admin 作用域的 OAuth 访问令牌，可通过 ant auth login --scope org:admin 或工作负载身份联合规则获取；不接受 Admin API 密钥。请参阅使用 Admin API 管理 WIF。

更新联合规则
$ ant beta:organization:federation:rules update
POST/v1/organizations/federation_rules/{federation_rule_id}

需要具有 org:admin 作用域的 OAuth 访问令牌，可通过 ant auth login --scope org:admin 或工作负载身份联合规则获取；不接受 Admin API 密钥。请参阅使用 Admin API 管理 WIF。

归档联合规则
$ ant beta:organization:federation:rules archive
POST/v1/organizations/federation_rules/{federation_rule_id}/archive

需要具有 org:admin 作用域的 OAuth 访问令牌，可通过 ant auth login --scope org:admin 或工作负载身份联合规则获取；不接受 Admin API 密钥。请参阅使用 Admin API 管理 WIF。

Beta组织联合规则工作区

添加联合规则工作区
$ ant beta:organization:federation:rules:workspaces add
POST/v1/organizations/federation_rules/{federation_rule_id}/workspaces

需要具有 org:admin 作用域的 OAuth 访问令牌，可通过 ant auth login --scope org:admin 或工作负载身份联合规则获取；不接受 Admin API 密钥。请参阅使用 Admin API 管理 WIF。

列出联合规则工作区
$ ant beta:organization:federation:rules:workspaces list
GET/v1/organizations/federation_rules/{federation_rule_id}/workspaces

需要具有 org:admin 作用域的 OAuth 访问令牌，可通过 ant auth login --scope org:admin 或工作负载身份联合规则获取；不接受 Admin API 密钥。请参阅使用 Admin API 管理 WIF。

移除联合规则工作区
$ ant beta:organization:federation:rules:workspaces remove
DELETE/v1/organizations/federation_rules/{federation_rule_id}/workspaces/{workspace_id}

需要具有 org:admin 作用域的 OAuth 访问令牌，可通过 ant auth login --scope org:admin 或工作负载身份联合规则获取；不接受 Admin API 密钥。请参阅使用 Admin API 管理 WIF。

Beta组织邀请

创建邀请
$ ant beta:organization:invites create
POST/v1/organizations/invites

通过电子邮件邀请用户加入组织。

列出邀请
$ ant beta:organization:invites list
GET/v1/organizations/invites

列出组织的邀请。

获取邀请
$ ant beta:organization:invites retrieve
GET/v1/organizations/invites/{invite_id}

按 ID 检索邀请。

删除邀请
$ ant beta:organization:invites delete
DELETE/v1/organizations/invites/{invite_id}

删除待处理的邀请。

Beta组织服务账号

创建服务账号
$ ant beta:organization:service-accounts create
POST/v1/organizations/service_accounts

需要具有 org:admin 作用域的 OAuth 访问令牌，可通过 ant auth login --scope org:admin 或工作负载身份联合规则获取；不接受 Admin API 密钥。请参阅使用 Admin API 管理 WIF。

列出服务账号
$ ant beta:organization:service-accounts list
GET/v1/organizations/service_accounts

需要具有 org:admin 作用域的 OAuth 访问令牌，可通过 ant auth login --scope org:admin 或工作负载身份联合规则获取；不接受 Admin API 密钥。请参阅使用 Admin API 管理 WIF。

获取服务账号
$ ant beta:organization:service-accounts retrieve
GET/v1/organizations/service_accounts/{service_account_id}

需要具有 org:admin 作用域的 OAuth 访问令牌，可通过 ant auth login --scope org:admin 或工作负载身份联合规则获取；不接受 Admin API 密钥。请参阅使用 Admin API 管理 WIF。

更新服务账号
$ ant beta:organization:service-accounts update
POST/v1/organizations/service_accounts/{service_account_id}

需要具有 org:admin 作用域的 OAuth 访问令牌，可通过 ant auth login --scope org:admin 或工作负载身份联合规则获取；不接受 Admin API 密钥。请参阅使用 Admin API 管理 WIF。

归档服务账号
$ ant beta:organization:service-accounts archive
POST/v1/organizations/service_accounts/{service_account_id}/archive

需要具有 org:admin 作用域的 OAuth 访问令牌，可通过 ant auth login --scope org:admin 或工作负载身份联合规则获取；不接受 Admin API 密钥。请参阅使用 Admin API 管理 WIF。

Beta组织服务账号工作区

将工作区添加到服务账号
$ ant beta:organization:service-accounts:workspaces add
POST/v1/organizations/service_accounts/{service_account_id}/workspaces

需要具有 org:admin 作用域的 OAuth 访问令牌，可通过 ant auth login --scope org:admin 或工作负载身份联合规则获取；不接受 Admin API 密钥。请参阅使用 Admin API 管理 WIF。

列出服务账号所属的工作区
$ ant beta:organization:service-accounts:workspaces list
GET/v1/organizations/service_accounts/{service_account_id}/workspaces

需要具有 org:admin 作用域的 OAuth 访问令牌，可通过 ant auth login --scope org:admin 或工作负载身份联合规则获取；不接受 Admin API 密钥。请参阅使用 Admin API 管理 WIF。

从服务账号中移除工作区
$ ant beta:organization:service-accounts:workspaces remove
DELETE/v1/organizations/service_accounts/{service_account_id}/workspaces/{workspace_id}

需要具有 org:admin 作用域的 OAuth 访问令牌，可通过 ant auth login --scope org:admin 或工作负载身份联合规则获取；不接受 Admin API 密钥。请参阅使用 Admin API 管理 WIF。

Beta组织用户

列出用户
$ ant beta:organization:users list
GET/v1/organizations/users

列出组织的成员。

获取用户
$ ant beta:organization:users retrieve
GET/v1/organizations/users/{user_id}

按用户 ID 检索组织成员。

更新用户
$ ant beta:organization:users update
POST/v1/organizations/users/{user_id}

更新成员的组织角色。

移除用户
$ ant beta:organization:users remove
DELETE/v1/organizations/users/{user_id}

将成员从组织中移除。

Beta组织工作区

列出工作区
$ ant beta:organization:workspaces list
GET/v1/organizations/workspaces
创建工作区
$ ant beta:organization:workspaces create
POST/v1/organizations/workspaces
获取工作区
$ ant beta:organization:workspaces retrieve
GET/v1/organizations/workspaces/{workspace_id}
更新工作区
$ ant beta:organization:workspaces update
POST/v1/organizations/workspaces/{workspace_id}
归档工作区
$ ant beta:organization:workspaces archive
POST/v1/organizations/workspaces/{workspace_id}/archive

Beta组织工作区速率限制

列出工作区速率限制
$ ant beta:organization:workspaces:rate-limits list
GET/v1/organizations/workspaces/{workspace_id}/rate_limits

列出工作区的速率限制（rate limit）。

设置工作区速率限制
$ ant beta:organization:workspaces:rate-limits update
POST/v1/organizations/workspaces/{workspace_id}/rate_limits/{rate_limit_id}

为工作区中的某个速率限制组设置或清除速率限制覆盖值。

Beta组织工作区成员

列出工作区成员
$ ant beta:organization:workspaces:members list
GET/v1/organizations/workspaces/{workspace_id}/members
创建工作区成员
$ ant beta:organization:workspaces:members add
POST/v1/organizations/workspaces/{workspace_id}/members
获取工作区成员
$ ant beta:organization:workspaces:members retrieve
GET/v1/organizations/workspaces/{workspace_id}/members/{user_id}
更新工作区成员
$ ant beta:organization:workspaces:members update
POST/v1/organizations/workspaces/{workspace_id}/members/{user_id}
删除工作区成员
$ ant beta:organization:workspaces:members remove
DELETE/v1/organizations/workspaces/{workspace_id}/members/{user_id}

Beta组织工作区服务账号

列出服务账号工作区成员
$ ant beta:organization:workspaces:service-accounts list
GET/v1/organizations/workspaces/{workspace_id}/service_accounts

需要具有 org:admin 作用域的 OAuth 访问令牌，可通过 ant auth login --scope org:admin 或工作负载身份联合规则获取；不接受 Admin API 密钥。请参阅使用 Admin API 管理 WIF。

创建服务账号工作区成员
$ ant beta:organization:workspaces:service-accounts add
POST/v1/organizations/workspaces/{workspace_id}/service_accounts

需要具有 org:admin 作用域的 OAuth 访问令牌，可通过 ant auth login --scope org:admin 或工作负载身份联合规则获取；不接受 Admin API 密钥。请参阅使用 Admin API 管理 WIF。

获取服务账号工作区成员
$ ant beta:organization:workspaces:service-accounts retrieve
GET/v1/organizations/workspaces/{workspace_id}/service_accounts/{service_account_id}

需要具有 org:admin 作用域的 OAuth 访问令牌，可通过 ant auth login --scope org:admin 或工作负载身份联合规则获取；不接受 Admin API 密钥。请参阅使用 Admin API 管理 WIF。

更新服务账号工作区成员
$ ant beta:organization:workspaces:service-accounts update
POST/v1/organizations/workspaces/{workspace_id}/service_accounts/{service_account_id}

需要具有 org:admin 作用域的 OAuth 访问令牌，可通过 ant auth login --scope org:admin 或工作负载身份联合规则获取；不接受 Admin API 密钥。请参阅使用 Admin API 管理 WIF。

删除服务账号工作区成员
$ ant beta:organization:workspaces:service-accounts remove
DELETE/v1/organizations/workspaces/{workspace_id}/service_accounts/{service_account_id}

需要具有 org:admin 范围的 OAuth 访问令牌，可通过 ant auth login --scope org:admin 或 "workload identity federation"（工作负载身份联合）规则获取；不接受 Admin API 密钥。请参阅使用 Admin API 管理 WIF。

Beta组织速率限制

列出组织速率限制
$ ant beta:organization:rate-limits list
GET/v1/organizations/rate_limits

列出您组织的 Messages API "rate limit"（速率限制）。

Beta组织合规设置

获取合规设置
$ ant beta:organization:compliance-settings retrieve
GET/v1/organizations/compliance_settings

检索您组织的合规设置。

更新合规设置
$ ant beta:organization:compliance-settings update
POST/v1/organizations/compliance_settings

更新您组织的合规设置。

Beta组织分析摘要

获取活动摘要
$ ant beta:organization:analytics:summaries list
GET/v1/organizations/analytics/summaries

获取某个日期范围内的组织级活动摘要。

Beta组织分析用户

列出用户活动
$ ant beta:organization:analytics:users list
GET/v1/organizations/analytics/users

获取给定日期的每用户活动，支持基于游标的分页。

Beta组织分析应用聊天项目

获取聊天项目用量
$ ant beta:organization:analytics:apps:chat:projects list
GET/v1/organizations/analytics/apps/chat/projects

获取指定日期的每项目活动，支持基于游标的分页。

Beta组织分析连接器

获取连接器使用情况
$ ant beta:organization:analytics:connectors list
GET/v1/organizations/analytics/connectors

获取给定日期的每连接器使用情况，支持基于游标的分页。

Beta组织分析插件

获取插件使用情况
$ ant beta:organization:analytics:plugins list
GET/v1/organizations/analytics/plugins

获取给定日期的每插件安装 + 调用使用情况，支持分页。

Beta组织分析技能

获取技能使用情况
$ ant beta:organization:analytics:skills list
GET/v1/organizations/analytics/skills

获取给定日期的每技能使用情况，支持基于游标的分页。

Beta组织分析Artifacts

获取 Artifact 活动
$ ant beta:organization:analytics:artifacts list
GET/v1/organizations/analytics/artifacts

获取给定日期的 Artifact 创建活动，按 MIME 类型细分。

Beta组织分析使用情况报告

获取随时间变化的令牌用量
$ ant beta:organization:analytics:usage-report list
GET/v1/organizations/analytics/usage_report

获取某个日期范围内随时间变化的令牌用量。

Beta组织分析用户用量报告

获取每用户令牌用量
$ ant beta:organization:analytics:user-usage-report list
GET/v1/organizations/analytics/user_usage_report

获取某个日期范围内的每用户令牌用量。

Beta组织分析成本报告

获取随时间变化的成本
$ ant beta:organization:analytics:cost-report list
GET/v1/organizations/analytics/cost_report

获取某个日期范围内随时间变化的成本（以美元计）。

Beta组织分析用户成本报告

获取每用户成本
$ ant beta:organization:analytics:user-cost-report list
GET/v1/organizations/analytics/user_cost_report

获取某个日期范围内的每用户成本（以美元计）。

Beta组织支出限额

设置支出限额
$ ant beta:organization:spend-limits set
POST/v1/organizations/spend_limits

设置支出限额。

获取支出限额
$ ant beta:organization:spend-limits retrieve
GET/v1/organizations/spend_limits/{spend_limit_id}

按 ID 检索支出限额。

删除支出限额
$ ant beta:organization:spend-limits delete
DELETE/v1/organizations/spend_limits/{spend_limit_id}

删除支出限额。

列出支出限额
$ ant beta:organization:spend-limits list
GET/v1/organizations/spend_limits

List the organization's spend limits.

Beta组织支出限额生效

列出生效的支出限额
$ ant beta:organization:spend-limits:effective list
GET/v1/organizations/spend_limits/effective

列出每位成员的生效支出限额及本周期至今的支出。

Beta组织支出限额提额请求

列出支出限额提额请求
$ ant beta:organization:spend-limits:increase-requests list
GET/v1/organizations/spend_limit_increase_requests

列出支出限额提额请求，最新的在前。

获取支出限额提额请求
$ ant beta:organization:spend-limits:increase-requests retrieve
GET/v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}

检索支出限额提额请求。

批准支出限额提额请求
$ ant beta:organization:spend-limits:increase-requests approve
POST/v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}/approve

批准待处理的支出限额提额请求。

拒绝支出限额提额请求
$ ant beta:organization:spend-limits:increase-requests deny
POST/v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}/deny

拒绝待处理的支出限额提额请求。

Beta组织RBAC 组

创建 RBAC 组
$ ant beta:organization:rbac-groups create
POST/v1/organizations/rbac_groups

在 Claude Enterprise 租户中创建 RBAC 组。通过 API 创建的组的来源类型为 "direct"。

列出 RBAC 组
$ ant beta:organization:rbac-groups list
GET/v1/organizations/rbac_groups

列出 Claude Enterprise 租户中的 RBAC 组。

获取 RBAC 组
$ ant beta:organization:rbac-groups retrieve
GET/v1/organizations/rbac_groups/{rbac_group_id}

按 ID 检索 RBAC 组。

更新 RBAC 组
$ ant beta:organization:rbac-groups update
POST/v1/organizations/rbac_groups/{rbac_group_id}

更新 RBAC 组的名称。当租户中的某个组织使用 SCIM 预配时，由身份提供商预配的组（来源类型为 "scim"）无法通过 API 修改。

删除 RBAC 组
$ ant beta:organization:rbac-groups delete
DELETE/v1/organizations/rbac_groups/{rbac_group_id}

删除 RBAC 组。当租户中的某个组织使用 SCIM 预配时，由身份提供商预配的组（来源类型为 "scim"）无法通过 API 删除。

Beta组织RBAC 组成员

列出 RBAC 组成员
$ ant beta:organization:rbac-groups:members list
GET/v1/organizations/rbac_groups/{rbac_group_id}/members

列出 RBAC 组的成员。

添加 RBAC 组成员
$ ant beta:organization:rbac-groups:members add
POST/v1/organizations/rbac_groups/{rbac_group_id}/members

将用户添加到 RBAC 组。当租户中的某个组织使用 SCIM 预配时，由身份提供商预配的组（来源类型为 "scim"）的成员资格无法通过 API 修改。

移除 RBAC 组成员
$ ant beta:organization:rbac-groups:members remove
DELETE/v1/organizations/rbac_groups/{rbac_group_id}/members/{user_id}

从 RBAC 组中移除用户。当租户中的某个组织使用 SCIM 预配时，由身份提供商预配的组（来源类型为 "scim"）的成员资格无法通过 API 修改。

Beta组织RBAC 角色

列出 RBAC 角色
$ ant beta:organization:rbac-roles list
GET/v1/organizations/rbac_roles

列出组织中的 RBAC 角色。

获取 RBAC 角色
$ ant beta:organization:rbac-roles retrieve
GET/v1/organizations/rbac_roles/{rbac_role_id}

按 ID 检索 RBAC 角色。

Beta组织RBAC 角色权限

列出 RBAC 角色权限
$ ant beta:organization:rbac-roles:permissions list
GET/v1/organizations/rbac_roles/{rbac_role_id}/permissions

列出 RBAC 角色授予的权限。

Beta组织插件

创建插件
$ ant beta:organization:plugins create
POST/v1/organizations/plugins

通过上传版本文件，创建组织拥有的插件及其第一个版本。

获取插件
$ ant beta:organization:plugins retrieve
GET/v1/organizations/plugins/{plugin_id}

按 ID 检索插件。

更新插件
$ ant beta:organization:plugins update
POST/v1/organizations/plugins/{plugin_id}

Change which stored version of an organization-owned Plugin is served to members, for example to roll back to an earlier one. This pins the served version: later uploads are stored but no longer change what is served, and pinning cannot currently be undone, here or in claude.ai.

列出插件
$ ant beta:organization:plugins list
GET/v1/organizations/plugins

列出在组织下创建的插件，按从新到旧排序：包括组织自有插件市场中的插件以及成员个人插件市场中的插件。

删除插件
$ ant beta:organization:plugins delete
DELETE/v1/organizations/plugins/{plugin_id}

永久删除一个插件及其包含的所有版本，效果与管理员在 claude.ai 中删除它完全相同。该插件可以属于组织，也可以属于某个成员，包括此后已离开组织的成员。

Beta组织插件版本

创建插件版本
$ ant beta:organization:plugins:versions create
POST/v1/organizations/plugins/{plugin_id}/versions

通过上传新版本的文件为组织所有的插件添加一个版本；除非该插件的提供版本已被固定，否则新版本将成为向成员提供的版本。

列出插件版本
$ ant beta:organization:plugins:versions list
GET/v1/organizations/plugins/{plugin_id}/versions

列出插件的版本，按从新到旧排序。

获取插件版本
$ ant beta:organization:plugins:versions retrieve
GET/v1/organizations/plugins/{plugin_id}/versions/{version}

按 ID 检索插件的某个版本，或检索插件的最新版本。

下载插件版本归档
$ ant beta:organization:plugins:versions download
GET/v1/organizations/plugins/{plugin_id}/versions/{version}/content

按原样下载某个版本的 .zip 归档文件。每次从成员个人插件市场下载插件都会记录在 Compliance API 活动源中。

Beta组织插件安装设置

列出插件安装设置
$ ant beta:organization:plugins:installation-settings list
GET/v1/organizations/plugins/{plugin_id}/installation_settings

列出组织所有插件的安装设置（这些设置说明插件面向哪些成员），按创建时间从新到旧排序。

设置插件安装设置
$ ant beta:organization:plugins:installation-settings set
POST/v1/organizations/plugins/{plugin_id}/installation_settings/{target}

为整个组织或某个 RBAC 组设置或更改组织所有插件的安装设置。

移除插件安装设置
$ ant beta:organization:plugins:installation-settings remove
DELETE/v1/organizations/plugins/{plugin_id}/installation_settings/{target}

移除组织所有插件针对整个组织或某个 RBAC 组的自身安装设置。

Beta组织插件共享

列出插件共享
$ ant beta:organization:plugins:shares list
GET/v1/organizations/plugins/{plugin_id}/shares

列出成员所有插件的所有者所授予的共享（共享给组织的所有成员、某个 RBAC 组或某个成员），按授予时间从新到旧排序。

Beta组织插件市场

列出插件市场
$ ant beta:organization:plugin-marketplaces list
GET/v1/organizations/plugin_marketplaces

列出插件所在的插件市场，按从新到旧排序：包括组织自有的市场及其成员的个人市场。

获取插件市场
$ ant beta:organization:plugin-marketplaces retrieve
GET/v1/organizations/plugin_marketplaces/{marketplace_id}

按 ID 检索插件市场。

更新插件市场
$ ant beta:organization:plugin-marketplaces update
POST/v1/organizations/plugin_marketplaces/{marketplace_id}

设置组织自有插件市场之一的默认安装设置。该市场中所有没有自身设置的插件（包括之后添加的插件）都会将此默认值作为其组织范围设置。

验证插件市场代码仓库
$ ant beta:organization:plugin-marketplaces validate-repository
POST/v1/organizations/plugin_marketplaces/validate_repository

Check whether a plugin marketplace held in a public GitHub repository would synchronize into claude.ai, without connecting or storing it.

验证插件市场归档
$ ant beta:organization:plugin-marketplaces validate-archive
POST/v1/organizations/plugin_marketplaces/validate_archive

Check whether a plugin marketplace, uploaded as a .zip of the marketplace directory, would synchronize into claude.ai, without connecting or storing it.

Beta组织遥测目标

创建遥测目标
$ ant beta:organization:telemetry-destinations create
POST/v1/organizations/telemetry_destinations

为组织注册一个 OpenTelemetry 目标。

列出遥测目标
$ ant beta:organization:telemetry-destinations list
GET/v1/organizations/telemetry_destinations

列出组织的目标，最新的排在最前，可选择仅列出覆盖指定工作区的目标。

检索遥测目标
$ ant beta:organization:telemetry-destinations retrieve
GET/v1/organizations/telemetry_destinations/{destination_id}

读取目标的配置、状态和最近的投递结果。

更新遥测目标
$ ant beta:organization:telemetry-destinations update
POST/v1/organizations/telemetry_destinations/{destination_id}

更改遥测目标的设置、状态或其覆盖的工作区。

删除遥测目标
$ ant beta:organization:telemetry-destinations delete
DELETE/v1/organizations/telemetry_destinations/{destination_id}

删除目标及其工作区列表。

测试遥测目标
$ ant beta:organization:telemetry-destinations test
POST/v1/organizations/telemetry_destinations/{destination_id}/test

使用目标已注册的标头向其发送一个名为 anthropic.test 的测试 span，仅发送一次且不重试，并报告目标的响应。无论目标是否以 2xx 状态响应，响应均为 200：其 result 的类型为 success，或类型为 failure 并在 error 中给出原因。目标的配置、state 和 delivery_health 不会改变。已禁用的目标也可以测试。对同一目标的两次测试之间请等待 10 秒；过早发出的请求可能会收到 429 状态。

Beta组织遥测目标工作区

列出遥测目标工作区
$ ant beta:organization:telemetry-destinations:workspaces list
GET/v1/organizations/telemetry_destinations/{destination_id}/workspaces

列出目标工作区列表中的工作区，最新条目排在最前。

添加遥测目标工作区
$ ant beta:organization:telemetry-destinations:workspaces add
POST/v1/organizations/telemetry_destinations/{destination_id}/workspaces/{workspace_id}

向目标的工作区列表中添加一个工作区。

移除遥测目标工作区
$ ant beta:organization:telemetry-destinations:workspaces remove
DELETE/v1/organizations/telemetry_destinations/{destination_id}/workspaces/{workspace_id}

从目标的工作区列表中移除一个工作区。

Beta组织Webhook

创建组织 Webhook 端点
$ ant beta:organization:webhooks create
POST/v1/organizations/webhooks

创建组织 webhook 端点。

列出组织 Webhook 端点
$ ant beta:organization:webhooks list
GET/v1/organizations/webhooks

列出组织的 webhook 端点。

获取组织 Webhook 端点
$ ant beta:organization:webhooks retrieve
GET/v1/organizations/webhooks/{webhook_endpoint_id}

按 ID 检索组织 webhook 端点。

更新组织 Webhook 端点
$ ant beta:organization:webhooks update
POST/v1/organizations/webhooks/{webhook_endpoint_id}

更新组织 webhook 端点。仅更改您发送的字段。

删除组织 Webhook 端点
$ ant beta:organization:webhooks delete
DELETE/v1/organizations/webhooks/{webhook_endpoint_id}

删除组织 webhook 端点。

重新生成组织 Webhook 端点签名密钥
$ ant beta:organization:webhooks regenerate-signing-secret
POST/v1/organizations/webhooks/{webhook_endpoint_id}/regenerate_signing_secret

替换组织 webhook 端点的签名密钥。旧密钥会立即失效。新密钥仅在此响应中返回。

Beta组织Claude TagSlack Channels

Set Up Slack Channel
$ ant beta:organization:claude-tag:slack-channels create
POST/v1/organizations/claude_tag/slack_channels

Set a Slack channel up for Claude Tag and return it with its identifier. If the channel is already set up, whether in claude.ai, by Claude's first use in it or by an earlier request, the existing channel is returned, so the request can be repeated. settings, when sent, is applied as an update applies it. Before a channel is set up, Claude's Slack app confirms with Slack that the channel is in the workspace, is not archived and is visible to the app; a channel that fails the confirmation returns 404. Setting the channel up and applying settings are two steps: when the second is refused, the response is the refusal, the channel stays set up with every setting unset, and the error's details.slack_channel_id holds the channel's identifier.

List Slack Channels
$ ant beta:organization:claude-tag:slack-channels list
GET/v1/organizations/claude_tag/slack_channels

List the set-up Slack channels of one Slack workspace, newest first by created_at. A channel that is not set up is not listed: Slack holds the full list of a workspace's channels. Pass slack_channel_id as well to look one channel up by its Slack identifiers: data then holds that channel, or is empty when it is not set up, and limit and page are ignored. With include_inherited=true each channel's settings holds what applies in it, and the request fails with 503 rather than resolve against a settings level that could not be read. A page cursor resumes only a request with the same include_inherited.

Get Slack Channel
$ ant beta:organization:claude-tag:slack-channels retrieve
GET/v1/organizations/claude_tag/slack_channels/{id}

Get one Slack channel and its settings. By default settings holds what the channel itself stores: a setting that is null there is not set on the channel and is inherited. With include_inherited=true, settings holds what applies in the channel once the settings levels above it are taken into account, and the request fails with 503 rather than resolve against a settings level that could not be read. Either way sources names the settings level each value comes from, so a caller tells the channel's own value from an inherited one by its source, not by whether it is null.

Update Slack Channel
$ ant beta:organization:claude-tag:slack-channels update
POST/v1/organizations/claude_tag/slack_channels/{id}

Change the settings a Slack channel stores. The update is partial: a setting left out is unchanged, and a setting sent as null is cleared, so the channel inherits it. If any value is refused, no setting in the request is stored. A group direct message takes no settings and returns 400.

Remove Slack Channel
$ ant beta:organization:claude-tag:slack-channels delete
DELETE/v1/organizations/claude_tag/slack_channels/{id}

Remove a Slack channel from Claude Tag. This deletes the channel's stored settings and its Bundle Targets at once, and then, in the background, the channel's sessions and their transcripts, its memory, its routines and the artifacts published from it. None of it can be restored. The channel in Slack and its messages are unchanged. The request is refused with 400 and error.details.error_code slack_channel_enabled while enabled resolves to true for the channel, as a read with include_inherited=true returns it: set enabled to false on the channel first. This guards against removing a channel in use by mistake; it is not a way to keep Claude out, because the removal deletes the channel's own enabled: false with its other settings, after which the channel inherits again and Claude's next use of it can set it up anew with a new identifier. The identifier returns 404 as soon as the request returns, so a repeated removal returns 404. A group direct message returns 400, and so does a channel that holds configuration this API does not manage.

Beta组织Claude TagSlack Workspaces

List Slack Workspaces
$ ant beta:organization:claude-tag:slack-workspaces list
GET/v1/organizations/claude_tag/slack_workspaces

List the set-up Slack workspaces the organization owns, newest first by created_at. Pass slack_workspace_id to look one workspace up by its Slack identifier: data then holds that workspace, or is empty when it is not set up. With include_inherited=true each workspace's settings holds what applies in it, and the request fails with 503 rather than resolve against a settings level that could not be read. A page cursor resumes only a request with the same include_inherited.

Get Slack Workspace
$ ant beta:organization:claude-tag:slack-workspaces retrieve
GET/v1/organizations/claude_tag/slack_workspaces/{id}

Get one Slack workspace and its settings. By default settings holds what the workspace itself stores: a setting that is null there is not set on the workspace and is inherited. With include_inherited=true, settings holds what applies in the workspace once the organization's Slack defaults are taken into account, and the request fails with 503 rather than resolve against a settings level that could not be read. Either way sources names the settings level each value comes from.

Update Slack Workspace
$ ant beta:organization:claude-tag:slack-workspaces update
POST/v1/organizations/claude_tag/slack_workspaces/{id}

Change the settings a Slack workspace stores. The update is partial: a setting left out is unchanged, and a setting sent as null is cleared, so the workspace inherits it. If any value is refused, no setting in the request is stored.

Beta组织Claude TagBundles

List Bundles
$ ant beta:organization:claude-tag:bundles list
GET/v1/organizations/claude_tag/bundles

List the organization's Bundles, newest first by created_at. A Bundle that Claude Tag manages for itself is not listed.

Get Bundle
$ ant beta:organization:claude-tag:bundles retrieve
GET/v1/organizations/claude_tag/bundles/{bundle_id}

Get one Bundle. What the Bundle grants (connectors, repositories and credentials) is never returned.

Beta组织Claude TagBundlesTargets

List Bundle Targets
$ ant beta:organization:claude-tag:bundles:targets list
GET/v1/organizations/claude_tag/bundles/{bundle_id}/targets

List the Slack channels and Slack workspaces a Bundle is attached to, newest first by created_at. Only channels and workspaces the organization owns are listed; a Bundle that is attached to anything else has no Bundle Target for it.

Attach Bundle
$ ant beta:organization:claude-tag:bundles:targets create
POST/v1/organizations/claude_tag/bundles/{bundle_id}/targets

Attach a Bundle to a Slack channel or a Slack workspace. A Bundle attached to a workspace can be used in the workspace and in every channel in it. Attaching a Bundle to a channel or workspace it is already attached to returns the existing Bundle Target. The channel or workspace must be set up: attaching never sets a channel up. A group direct message takes no Bundle and returns 400.

Get Bundle Target
$ ant beta:organization:claude-tag:bundles:targets retrieve
GET/v1/organizations/claude_tag/bundles/{bundle_id}/targets/{target_id}

Get one Bundle Target. Returns 404 when target_id is the identifier of another Bundle's Bundle Target, or the Bundle Target was detached.

Detach Bundle
$ ant beta:organization:claude-tag:bundles:targets delete
DELETE/v1/organizations/claude_tag/bundles/{bundle_id}/targets/{target_id}

Detach a Bundle from a Slack channel or a Slack workspace. A repeated detach returns 404.