Claude Tag API
從您自己的系統管理 Claude Enterprise 組織在 Slack 中的 Claude Tag:讀取及變更 Slack 頻道與工作區的設定、查看哪些設定生效及其原因,並附加存取套組。
Claude Tag 是在 Slack 中以團隊成員身分工作的 Claude:有人在頻道中提及 Claude,Claude 就會在討論串中回答。Claude Tag API 讓您能從自己的系統讀取和變更 Claude Tag 設定,這些設定原本需由組織擁有者在 claude.ai > 組織設定 > Claude 標籤中手動設定。您可以用它從核准工作流程中逐一為頻道開啟 Claude、將設定保存在版本控制中,或稽核每個頻道中生效的設定。
Claude Tag 是 claude.ai 的產品。此 API 為 Claude Enterprise 組織管理 Claude Tag,與 Claude Platform 工作區、API 使用量或 Claude Console 無關。
端點
此 API 在四種資源中提供 14 個端點:
| 資源 | 端點 |
|---|---|
| Slack 頻道:設定頻道、列出工作區的頻道或依 Slack ID 尋找頻道、讀取頻道、變更其設定、移除頻道 | POST /v1/organizations/claude_tag/slack_channelsGET /v1/organizations/claude_tag/slack_channelsGET /v1/organizations/claude_tag/slack_channels/{id}POST /v1/organizations/claude_tag/slack_channels/{id}DELETE /v1/organizations/claude_tag/slack_channels/{id} |
| Slack 工作區:列出您的工作區或依 Slack ID 尋找工作區、讀取工作區、變更其設定 | GET /v1/organizations/claude_tag/slack_workspacesGET /v1/organizations/claude_tag/slack_workspaces/{id}POST /v1/organizations/claude_tag/slack_workspaces/{id} |
| Bundle:列出您組織的存取套組、讀取其中一個(唯讀) | GET /v1/organizations/claude_tag/bundlesGET /v1/organizations/claude_tag/bundles/{bundle_id} |
| Bundle 目標:列出 Bundle 附加的位置、將其附加到頻道或工作區、讀取一項附加、將其分離 | GET /v1/organizations/claude_tag/bundles/{bundle_id}/targetsPOST /v1/organizations/claude_tag/bundles/{bundle_id}/targetsGET /v1/organizations/claude_tag/bundles/{bundle_id}/targets/{target_id}DELETE /v1/organizations/claude_tag/bundles/{bundle_id}/targets/{target_id} |
此版本涵蓋 Slack。連線和中斷連線 Slack 工作區或 Enterprise Grid、您組織的 Slack 預設值、建立和編輯存取套組、支出上限,以及設定中五項設定以外的所有 Claude Tag 設定,仍在 claude.ai 中處理。
先決條件
- 您的組織必須使用 Claude Enterprise 方案,已設定 Claude Tag,並已連線至少一個 Slack 工作區或 Enterprise Grid。
- 您的主要擁有者在 claude.ai > 組織設定 > API 中建立具有
read:claude_tag範圍、write:claude_tag範圍或兩者皆有的 Admin API 金鑰。請參閱為 Claude Enterprise 組織建立金鑰。 - 每個請求都帶有三個標頭:
x-api-key、anthropic-version: 2026-10-21(請參閱 API 版本)以及anthropic-beta: experimental-claude-tag-2026-10-21。
在 Python、TypeScript、C#、Go、Java、PHP 和 Ruby 中,SDK 將這些端點提供於 client.beta.organization.claude_tag 之下,ant CLI 則提供於 ant beta:organization:claude-tag 之下;它們會替您傳送 anthropic-version 和 anthropic-beta 標頭。本頁的範例從 ANTHROPIC_API_KEY 環境變數讀取 Admin API 金鑰。當 SDK 或 CLI 替您擷取更多頁面時,limit 設定的是每頁大小,而非總數(請參閱分頁)。
API 金鑰屬於組織,在建立者離開後仍會繼續運作。請勿分享金鑰,也不要將其簽入原始碼控制系統。
快速入門
列出您組織在 Claude Tag 中的 Slack 工作區:
client = anthropic.Anthropic()
workspaces = client.beta.organization.claude_tag.slack_workspaces.list()
# 視需要自動擷取更多頁面。
for workspace in workspaces:
print(f"{workspace.id}: {workspace.slack.workspace_id}"){
"data": [
{
"type": "slack_workspace",
"id": "slws_011CZkZnWa7xPc3uJfZe5LgT",
"slack": {
"workspace_id": "T01ABCD2EFG"
},
"settings": {
"enabled": null,
"instructions": "Answer in English unless asked otherwise.",
"model": null,
"environment_id": null,
"guest_policy": null
},
"sources": {
"enabled": null,
"instructions": [
{
"type": "slack_workspace",
"slack_workspace_id": "slws_011CZkZnWa7xPc3uJfZe5LgT"
}
],
"model": null,
"environment_id": null,
"guest_policy": null
},
"created_at": "2026-09-02T17:04:11Z",
"updated_at": "2026-10-06T09:41:53Z"
}
],
"next_page": null
}在 settings 中為 null 的設定表示此工作區未設定該項目,因此工作區會繼承它,且該設定沒有來源。若要改為讀取實際生效的值,請參閱儲存值與繼承值。
範圍
| 範圍 | 授予的權限 |
|---|---|
read:claude_tag | 本頁上的每個 GET 端點。 |
write:claude_tag | 本頁上的每個 POST 和 DELETE 端點。它不授予讀取權限,但變更的回應會包含已變更的資源。 |
一個金鑰可以同時具有兩種範圍。先查詢頻道再變更頻道的整合需要兩者。沒有其他範圍能授予這些端點的存取權,且在 Claude Console 中建立的金鑰無法在此使用。
金鑰必須屬於整個組織。組織一律是金鑰所屬的組織,任何請求都不會指定組織。anthropic-workspace-id 標頭會被忽略,因為此處沒有任何內容屬於 Claude Platform 工作區。
關鍵概念
本頁與 claude.ai 中的名稱
| 此 API | claude.ai 與 Slack |
|---|---|
| Slack 工作區 | Slack 工作區。Slack 自己的 API 稱之為 team,因此本頁中 Slack 自己的工作區 ID 在該處即為 team ID。它與 Claude Platform 工作區無關,後者的 ID 以 wrkspc_ 開頭。 |
| Slack 預設值 | 預設 Slack 存取權限:適用於每個工作區和頻道的設定。組織擁有者在 claude.ai 中變更這些設定;此 API 會顯示頻道或工作區在何處繼承這些設定。 |
| 設定層級 | 一個範圍:頻道、工作區或 Slack 預設值 |
| Bundle | 存取套組(Claude Tag 詞彙表) |
enabled | Enable Claude Tag in Slack(在 Slack 中啟用 Claude Tag) 切換開關 |
instructions | 自訂指示 |
model | 模型 |
environment_id | 環境 |
guest_policy | How should Claude work in channels with guests(Claude 在有訪客的頻道中應如何運作):restrict 即限制,channel_only 即僅限頻道,allow 即完整存取權 |
已設定的頻道和工作區
當 Claude Tag 為某個頻道或工作區保存設定記錄時,該頻道或工作區即為已設定(set up)。只有已設定的頻道或工作區才有 id,也只有它們會被列出:工作區的完整頻道清單由 Slack 保存,而非此 API。
- 當組織擁有者在 claude.ai 中連線工作區時,該工作區即完成設定。當擁有者連線 Slack Enterprise Grid 時,該 Grid 的工作區會在稍後完成設定。Claude 在工作區中的首次使用,或您在其中設定的第一個頻道,會設定任何尚未設定的工作區。沒有其他端點會設定工作區,也沒有端點會移除工作區。
- 頻道可在 claude.ai 中設定、由 Claude 在其中的首次使用設定,或透過設定頻道設定。
當您組織與某工作區的連線處於啟用狀態時,您的組織即擁有該工作區,並擁有其中的頻道。Slack Enterprise Grid 將數個工作區歸於同一家公司之下。當您組織與某 Grid 的連線處於啟用狀態時,它也擁有該 Grid 中所有未被其他組織連線的工作區。這類工作區與其他工作區無異:一旦設定完成,它就會有 id、會被列出,並可被讀取、變更和指派 Bundle,其頻道也可被列出。Grid 本身不是此 API 的資源,也沒有 id。您不擁有的頻道或工作區會傳回與不存在者相同的 404。
您的組織僅透過 Grid 擁有的工作區,在設定完成之前,凡是以 Slack 自己的 ID 指定它的請求都會傳回該 404:包括尋找該工作區、列出其頻道,或查詢其中尚未設定的頻道。您仍可在其中設定頻道,這也會同時設定該工作區,且不儲存任何設定。
與整個 Grid 共用的頻道,可以儲存在 Grid 自己的 Slack ID(以 E 開頭)之下,而非某個工作區的 ID 之下。此時該 ID 即為頻道的 slack.workspace_id,以它作為 slack_workspace_id 列出頻道會傳回這些頻道。沒有任何工作區物件具有此 ID:如果擁有者在 claude.ai 中將設定儲存在 Grid 本身,sources 可能會將其指名為一個 slack_workspace,而讀取其 id 時會傳回 404。
ID
您是透過 Slack 顯示的 ID 來識別頻道。請使用依 Slack ID 尋找頻道查詢一次其 id,然後儲存並使用該 id。
| ID | 前綴 | 出現位置 |
|---|---|---|
| Slack 頻道資源 | slch_ | 頻道上的 id;請求主體和回應中的 slack_channel_id |
| Slack 工作區資源 | slws_ | 工作區上的 id;請求主體和回應中的 slack_workspace_id |
| Bundle | capp_ | Bundle 上的 id;路徑中的 {bundle_id} |
| Bundle 目標 | btgt_ | Bundle 目標上的 id;路徑中的 {target_id} |
| Slack 自己的工作區 ID | T,或 Grid 自己的 ID 為 E(請參閱已設定的頻道和工作區) | slack.workspace_id;slack_workspace_id 查詢參數 |
| Slack 自己的頻道 ID | C 或 G | slack.channel_id;slack_channel_id 查詢參數 |
查詢參數或請求主體中不以 C 或 G 開頭的 Slack 頻道 ID 會傳回 400;任何在第一個字母之後含有大寫字母和數字以外字元、或長度超過 32 個字元的 Slack ID 也是如此。
在頻道或工作區保持設定期間,無論您在其上變更什麼,id 都不會改變,唯一的例外請見唯讀模式。被移除後又重新設定的頻道或工作區會有新的 id,舊的 id 會持續傳回 404。當已儲存的 id 傳回不含 error_code 的 404 時,請使用相同的金鑰和標頭列出您的工作區。該請求未指定任何頻道或工作區,因此如果它傳回 200,表示該 id 已不存在:請依 Slack ID 重新尋找該頻道或工作區。任何其他狀態都無法說明該 id 的情況:請保留您已儲存的 id 值,並參閱錯誤回應。
設定
每個設定層級都儲存相同的五項設定,皆為選用:
| 設定 | 類型 | 說明 |
|---|---|---|
enabled | boolean | Claude 是否開啟。 |
instructions | string | Claude 在每個工作階段中都會讀取的常設指引。去除前後空白後最多 8,192 個字元。空白文字會清除此設定。 |
model | string | 新工作階段開始時使用的模型:您的組織可搭配 Claude Tag 使用的模型 ID。最多 128 個字元。 |
environment_id | string | 工作階段執行所在的雲端環境,前綴為 env_。它必須處於啟用狀態並屬於您的組織。 |
guest_policy | object | 當頻道中有 Slack 訪客時,Claude 對頻道中所有人的行為:{"type": "allow"}(Claude 會回答)、{"type": "restrict"}(Claude 不回答),或 {"type": "channel_only"}(Claude 僅使用附加到頻道本身的 Bundle 回答;如果您的組織無法使用 channel_only,設定它的請求會傳回 400)。請參閱限制訪客頻道,了解它在透過 Slack Connect 或跨 Enterprise Grid 共用的頻道中的意義。 |
model 和 environment_id 會在您寫入時檢查,之後不再檢查:如果模型或環境之後變更,回應仍會持續傳回已儲存的值。
如果組織擁有者已在 claude.ai 中將某個設定層級設為使用自行託管的「runner pool」(執行器集區),其 environment_id 會傳回該集區的 ID,以 ccpool_ 開頭。此 API 無法設定執行器集區,對於在已儲存執行器集區的設定層級上變更或清除 environment_id 的請求,會傳回 400。
儲存值與繼承值
設定存在於三個層級:頻道、頻道所在的工作區,以及由組織擁有者在 claude.ai 中設定的您組織的 Slack 預設值。每個層級只儲存在該層級上設定的內容。頻道或工作區物件的 settings 可以包含以下兩種內容之一:
- 它儲存的內容。除非您另行要求,否則回應包含的就是這個。未在頻道或工作區上設定的設定為
null。可用它與您在其他地方保存的組態進行比較。 - 在其中實際套用的內容,即將每個層級都納入考量後的結果。若要取得此內容,請在任何傳回頻道或工作區的
GET請求中加入「query parameter」(查詢參數)include_inherited=true,這兩個清單也包含在內。您可以用它來進行稽核,或找出 Claude 在某個頻道中為何會有這樣的行為。此參數預設為false,若值不是布林值則會傳回400。設定頻道或變更設定的請求不接受此參數,若您傳送它則會傳回400;其回應包含所儲存的內容。
在這兩種情況下,sources 都會針對每項設定指出 settings 中的值來自哪個層級。不使用 include_inherited 時,頻道或工作區已儲存之設定的來源會指名該頻道或工作區本身,未儲存的設定則沒有來源:null,或對 instructions 而言為空列表。使用 include_inherited=true 時,除了 instructions 之外的每項設定都有來源,沒有任何層級設定的設定其來源為 {"type": "default"};當沒有任何層級設定 instructions 時,它為 null 且其來源列表為空。因此,若要區分頻道或工作區自行設定的值與它繼承的值,請查看其來源,而非該值是否為 null。
每項設定各自獨立解析:
| 設定 | 規則 | 當沒有任何層級設定時 |
|---|---|---|
enabled | 由設定它的最近層級決定值,因此頻道上的 true 會在該處開啟 Claude,即使其工作區儲存的是 false。 | true |
instructions | 累加。所有設定它的層級的文字會由最廣的層級開始依序串接,中間以空白行分隔。 | null |
model | 由設定它的最近層級決定值。 | null:Claude 使用產品的預設模型 |
environment_id | 由設定它的最近層級決定值。 | null |
guest_policy | 由設定它的最近層級決定值。 | restrict |
例如,某個組織在其 Slack 預設值上儲存了指示、在某個工作區關閉了 Claude,並在該工作區的某個頻道上設定了模型。以 include_inherited=true 讀取時,該頻道會顯示這三個值以及各自的來源:
{
"type": "slack_channel",
"id": "slch_011CZkZmRt4vNq8sHbYw2KdX",
"slack": {
"workspace_id": "T01ABCD2EFG",
"channel_id": "C05HJKL6MNP"
},
"settings": {
"enabled": false,
"instructions": "Be brief.",
"model": "claude-opus-5-5",
"environment_id": null,
"guest_policy": { "type": "restrict" }
},
"sources": {
"enabled": {
"type": "slack_workspace",
"slack_workspace_id": "slws_011CZkZnWa7xPc3uJfZe5LgT"
},
"instructions": [{ "type": "slack_default" }],
"model": {
"type": "slack_channel",
"slack_channel_id": "slch_011CZkZmRt4vNq8sHbYw2KdX"
},
"environment_id": { "type": "default" },
"guest_policy": { "type": "default" }
},
"created_at": "2026-10-19T16:20:05Z",
"updated_at": "2026-10-19T16:24:38Z"
}不使用此參數讀取時,同一個頻道的 settings 中只有其 model 和四個 null 設定;在 sources 中,model 指名該頻道,instructions 為空列表,其他三項為 null。
來源為下列其中之一:
type | 意義 |
|---|---|
slack_channel | 該頻道,以 slack_channel_id 指名。 |
slack_workspace | 該工作區,以 slack_workspace_id 指名。 |
slack_parent_channel | 程式碼頻道的父頻道,以 slack_channel_id 指名。程式碼頻道是從另一個頻道啟動的頻道。當父頻道是同一工作區中的公開頻道時,它位於該頻道與工作區之間,且只貢獻 instructions 和 environment_id。 |
slack_grid_channel | 在其 Slack Enterprise Grid 的另一個工作區下設定的同一個 Slack 頻道,以 slack 之下 Slack 自己的 ID 指名。它只貢獻 enabled:當頻道及其工作區都未設定 enabled 時,會套用在 Grid 另一個工作區下為該頻道儲存的 true。 |
slack_default | 您組織的 Slack 預設值,沒有 ID。 |
default | 沒有任何層級設定值,因此套用內建預設值。 |
sources.instructions 會列出每個貢獻文字的層級,由最廣的層級開始,這也是其文字在 settings.instructions 中的順序;若沒有任何層級貢獻,則為空。它說明誰的文字排在前面,而非某個層級的文字在何處結束:若要取得某個層級自己的文字,請不使用 include_inherited 讀取該頻道或工作區,若是 Slack 預設值,則請在 claude.ai 中查看。指名頻道或工作區的來源一律帶有其 ID,且絕不為 null:在 slack_channel_id 或 slack_workspace_id 中為此 API 的 id,或在 slack_grid_channel 上,為 slack 之下 Slack 自己的 ID,與頻道物件上的相同。
使用 include_inherited=true 時,如果某個層級無法讀取,請求會以 503 失敗,而不會在缺少該層級的情況下回應。
變更設定
兩個更新端點和設定頻道都依相同規則接受 settings 物件:
- 您省略的設定保持不變。
{"settings": {"enabled": false}}會關閉 Claude,並讓其他四項設定維持原樣。 - 您以
null傳送的設定會被清除,因此該層級會再次繼承它。 - 全有或全無。如果請求中有任何值被拒絕,請求中的任何設定都不會被儲存。
- 可安全重複。每次變更都會讓資源維持第一個相同請求所造成的狀態,因此沒有端點接受
Idempotency-Key。未改變任何內容的請求不會寫入任何內容,也不會記錄 Activity Feed 事件。 - 最後寫入者優先。沒有請求接受前置條件。兩個呼叫者各自讀取資源後再變更同一項設定,會互相覆寫。只有在另一項變更與您執行中的請求重疊時才會傳回
409;您的請求要求變更或刪除的內容都未執行,但設定請求可能已經設定了頻道,因此請重新讀取資源,若仍需要則重新傳送變更。
變更頻道上的 guest_policy 可能會結束該頻道中正在執行的工作階段。它們會在背景中結束,回應不會等待其完成。
唯讀模式
API / Terraform read-only mode(唯讀模式)是組織擁有者在 claude.ai 的 Claude Tag 設定中開啟和關閉的設定。這個名稱描述的是 claude.ai 和 Slack:當此模式開啟時,它們會拒絕人員對此 API 所管理內容的變更,因此只有金鑰能進行這些變更。它們也會拒絕一些沒有金鑰會進行的相關變更,例如變更 Slack 預設值上的設定,因此在擁有者關閉此模式之前,沒有人能進行這些變更。它並不會讓此 API 變成唯讀。本頁的每個端點無論此模式開啟或關閉,回應方式都相同,也沒有端點會讀取或變更此模式。
當此模式關閉時,人員和金鑰會變更相同的設定,並附加和卸離相同的 Bundle,每次變更都會取代已儲存的內容。如果您的管線應該是唯一的變更來源,請開啟此模式。
當此模式開啟時,claude.ai 和 Slack 會拒絕:
- 變更頻道、工作區或 Slack 預設值(金鑰也不會變更)上五項設定中的任何一項
- 在 claude.ai 中設定頻道、移除頻道、新增已連線 Enterprise Grid 的工作區,或中斷工作區或 Grid 的連線
- 將 Bundle 附加到頻道或工作區、將其分離,或刪除附加在頻道或工作區上的 Bundle
有些事無論如何都仍可進行:擁有者仍可連線新的工作區或 Grid、建立和編輯 Bundle,以及變更此 API 未管理的 Claude Tag 設定。Claude 的首次使用仍會設定頻道或尚未設定的 Grid 工作區,在 Slack 中刪除頻道仍會將其移除,解除安裝 Claude 的 Slack 應用程式仍會中斷該工作區或 Grid 的連線。
當此模式關閉時,在 claude.ai 中設定一個已設定的頻道可能會取代該頻道的紀錄,但僅限於尚未保存任何內容的頻道:即由 Claude 的首次使用所設定,或由此 API 在沒有 settings 的情況下設定,且之後沒有人在其上儲存設定或附加 Bundle 的頻道。該頻道隨後會有新的 id,舊的 id 會傳回 404。任何其他頻道在被移除之前都會保留其 id。
群組私訊
Slack 群組私訊的 ID 具有頻道的格式,因此 Claude 在其中的使用會像頻道一樣設定它:它會有 id、會被列出,並可被讀取。透過此 API 設定群組私訊、變更其設定、將 Bundle 附加到其上,以及移除它,都會傳回 400,但對已設定者省略 settings 的設定請求會以 200 傳回它,如同讀取一樣。從其上分離 Bundle 是允許的。
範例工作流程
僅在已核准的頻道中開啟 Claude
任何成員都可以邀請 Claude 加入公開頻道。若要讓 Claude 只在您核准的地方開啟:
- 請組織擁有者在 claude.ai 中透過預設 Slack 存取權限下的 Enable Claude Tag in Slack 切換開關,在所有地方關閉 Claude,這會在您組織的 Slack 預設值上將
enabled儲存為false。在他們進行此操作時,唯讀模式必須為關閉。 - 當您的核准系統核准某個頻道時,以
"settings": {"enabled": true}設定該頻道。此請求接受 Slack 自己的 ID,且即使頻道已設定也會傳回該頻道,因此可安全重複。 - 在同一次執行中,附加該團隊獲核准的 Bundle,讓頻道的第一個工作階段就具備其工具。
將設定保存在版本控制中
- 以 Slack 為每個頻道顯示的 ID 作為您組態的鍵,並依這些 ID 尋找每個頻道。
- 不使用
include_inherited讀取每個頻道,並將其settings與您儲存庫中宣告的內容比較。使用此參數時,會混入繼承的值。 - 只傳送不同的設定,並對您的儲存庫不再宣告的設定傳送
null。 - 請組織擁有者開啟唯讀模式,讓沒有人手動變更相同的設定。
稽核所有地方生效的設定
- 列出您的工作區,然後列出每個工作區的頻道,兩者都使用
include_inherited=true,讓每個項目都包含其中實際生效的內容。如果您的組織連線了 Enterprise Grid,也請列出儲存在該 Grid 自己 Slack ID 之下的頻道。請參閱已設定的頻道和工作區。 - 標記您的政策禁止的項目,例如
enabled為true但沒有核准紀錄的頻道,或guest_policy為allow的頻道。 - 列出您的 Bundle,然後列出每個 Bundle 的目標,以查看敏感系統的存取權附加在何處。
Slack 頻道
頻道物件描述一個 Slack 頻道:
| 欄位 | 說明 |
|---|---|
type | slack_channel。 |
id | 前綴為 slch_。請參閱 ID。 |
slack | Slack 自己的 ID:workspace_id 為頻道所在的工作區,channel_id 為該頻道。 |
settings | 頻道本身儲存的內容,或在使用 include_inherited=true 時,為其中實際生效的內容。一律存在,並包含全部五項設定;未設定者為 null。請參閱儲存值與繼承值。 |
sources | 針對每項設定,settings 中的值來自的層級。一律存在。 |
created_at | 頻道設定的時間。 |
updated_at | Claude Tag 對該頻道的紀錄最後一次變更的時間。無論在此處、claude.ai 或 Slack 中,每次設定變更時它都會更新,也可能因此處任何回應都未顯示的變更而更新。請將較晚的值視為重新讀取頻道的理由,而非設定已變更的證明。附加或分離 Bundle 本身不會使它更新。 |
不是有效 slch_ 識別碼的 id 會傳回 400。有效但未指向您組織任何頻道的 id 會傳回 404。
設定頻道
POST /v1/organizations/claude_tag/slack_channels 會設定 Slack 頻道並傳回它。slack.workspace_id 和 slack.channel_id 為必要項目,且為 Slack 自己的 ID。settings 為選用項目,並遵循變更設定。如果頻道已設定,請求會傳回現有頻道並套用 settings;兩種情況下的回應都是 200。需要 write:claude_tag 範圍。
client = anthropic.Anthropic()
channel = client.beta.organization.claude_tag.slack_channels.create(
slack={"workspace_id": "T01ABCD2EFG", "channel_id": "C05HJKL6MNP"},
settings={"instructions": "Answer in the language of the question."},
)
print(channel.id){
"type": "slack_channel",
"id": "slch_011CZkZmRt4vNq8sHbYw2KdX",
"slack": {
"workspace_id": "T01ABCD2EFG",
"channel_id": "C05HJKL6MNP"
},
"settings": {
"enabled": null,
"instructions": "Answer in the language of the question.",
"model": null,
"environment_id": null,
"guest_policy": null
},
"sources": {
"enabled": null,
"instructions": [
{
"type": "slack_channel",
"slack_channel_id": "slch_011CZkZmRt4vNq8sHbYw2KdX"
}
],
"model": null,
"environment_id": null,
"guest_policy": null
},
"created_at": "2026-10-19T16:20:05Z",
"updated_at": "2026-10-19T16:20:05Z"
}在設定頻道之前,Claude 的 Slack 應用程式會向 Slack 確認該頻道位於該工作區中、未封存,且應用程式可以看見它。未通過此檢查的頻道會傳回 404,未安裝 Claude Slack 應用程式的工作區也是如此。對於您的組織透過 Enterprise Grid 擁有的工作區,應用程式必須安裝在該 Grid 上。
設定頻道和套用 settings 是兩個步驟。當此請求設定了頻道,而 settings 隨後以 400、404 或 409 被拒絕時,回應即為該拒絕,而頻道會保持設定狀態且不儲存任何內容(在 409 之後,除非重疊的變更移除或取代了它)。該拒絕帶有以 slack_channel_set_up_ 開頭的 error_code,以及位於 error.details.slack_channel_id 中的新頻道 id(請參閱錯誤回應)。請修正 settings,並以更新將其傳送到該 id,或再次傳送設定請求。如果頻道原本已設定,被拒絕的 settings 會傳回與更新相同的錯誤,而頻道會保留其已儲存的內容。在任一種情況下,500 或 503 都不帶 error_code,也不會說明頻道是否已設定或 settings 是否已儲存:請再次傳送設定請求。
列出頻道
GET /v1/organizations/claude_tag/slack_channels 會列出一個工作區中已設定的頻道,依 created_at 由新到舊排序。slack_workspace_id 為必要項目,且為 Slack 自己的工作區 ID。加入 include_inherited=true 可讓每個頻道包含其中實際生效的內容(請參閱儲存值與繼承值)。一頁可能包含少於 limit 個頻道,甚至沒有任何頻道,但 next_page 仍有值,因此請持續請求頁面,直到 next_page 為 null(請參閱分頁)。需要 read:claude_tag 範圍。
client = anthropic.Anthropic()
channels = client.beta.organization.claude_tag.slack_channels.list(
slack_workspace_id="T01ABCD2EFG"
)
# 會視需要自動擷取更多頁面。
for channel in channels:
print(f"{channel.id}: {channel.slack.channel_id}")回應為 {"data": [...], "next_page": ...},其中每個項目都是頻道物件。指向您組織未擁有之工作區的 slack_workspace_id 會傳回 404;指向您組織僅透過 Enterprise Grid 擁有之工作區者,在該工作區設定之前也是如此(請參閱已設定的頻道和工作區)。
依 Slack ID 尋找頻道
加入 slack_channel_id(Slack 自己的頻道 ID)即可查詢單一頻道。data 會包含該頻道,若頻道尚未設定則為空。在尚未設定且您的組織僅透過 Enterprise Grid 擁有的工作區中,尚未設定的頻道會改為傳回 404。查詢不會分頁:它會忽略 page 以及任何介於 1 到 100 之間的 limit(超出該範圍的 limit 仍會傳回 400),且其 next_page 為 null。這就是找出頻道 id 的方式。
client = anthropic.Anthropic()
page = client.beta.organization.claude_tag.slack_channels.list(
slack_workspace_id="T01ABCD2EFG",
slack_channel_id="C05HJKL6MNP",
)
for channel in page.data:
print(channel.id)將 slch_ ID 作為 slack_channel_id 傳遞會傳回 400。
取得頻道
GET /v1/organizations/claude_tag/slack_channels/{id} 會傳回頻道物件,其中包含頻道儲存的內容。若要改為讀取其中實際生效的內容,請參閱讀取頻道中實際生效的內容。需要 read:claude_tag 範圍。
client = anthropic.Anthropic()
channel = client.beta.organization.claude_tag.slack_channels.retrieve(
"slch_011CZkZmRt4vNq8sHbYw2KdX"
)
print(channel.settings.enabled)讀取頻道中實際生效的內容
使用 include_inherited=true 的相同請求會傳回頻道物件,其中 settings 包含頻道中實際生效的內容,sources 則說明每個值的來源。儲存值與繼承值展示了完整的回應;其中 enabled 和 guest_policy 絕不為 null。如果某個層級無法讀取,請求會以 503 失敗,而不會在缺少該層級的情況下回應。需要 read:claude_tag 範圍。
client = anthropic.Anthropic()
channel = client.beta.organization.claude_tag.slack_channels.retrieve(
"slch_011CZkZmRt4vNq8sHbYw2KdX",
include_inherited=True,
)
print(channel.settings.instructions)更新頻道
POST /v1/organizations/claude_tag/slack_channels/{id} 會變更頻道的設定並傳回頻道物件。settings 為必填,並遵循變更設定的規則。需要 write:claude_tag 範圍。
在單一頻道中關閉 Claude,並讓其他設定維持原狀:
client = anthropic.Anthropic()
channel = client.beta.organization.claude_tag.slack_channels.update(
"slch_011CZkZmRt4vNq8sHbYw2KdX",
settings={"enabled": False},
)
print(channel.settings.enabled)清除頻道的指示,讓只有繼承的指示生效:
client = anthropic.Anthropic()
channel = client.beta.organization.claude_tag.slack_channels.update(
"slch_011CZkZmRt4vNq8sHbYw2KdX",
settings={"instructions": None},
)
print(channel.settings.instructions)移除頻道
DELETE /v1/organizations/claude_tag/slack_channels/{id} 會將頻道從 Claude Tag 中移除。這與組織擁有者在 claude.ai 中執行的移除操作相同,效果也相同。它不會刪除、封存或變更 Slack 中的頻道,也不會影響其中的任何訊息。需要 write:claude_tag 範圍。
只有在頻道中的 Claude 為關閉狀態時才能移除該頻道。當 enabled 對該頻道解析為 true(如讀取頻道中實際生效的內容所傳回)時,請求會傳回 400,並帶有 error_code: "slack_channel_enabled"。請先在頻道上將 enabled 設為 false,然後再次傳送請求。唯一的例外是具有受限合規組態的組織:它無法進行該變更,因此無論 Claude 在頻道中是否開啟,其請求都會移除該頻道。如果此檢查所需的某個層級無法讀取,請求會傳回 503,且不會移除任何內容。
此檢查可防止誤刪正在使用中的頻道。它不會在之後讓 Claude 遠離該頻道。移除會刪除頻道自己的設定,包括值為 false 的 enabled,因此從那時起,只有頻道繼承的內容決定 Claude 在該處是否開啟。如果這讓 Claude 開啟,Claude 會在下一次被提及時再次於頻道中回答,而該次使用會重新設定頻道:新的 id、沒有自己的設定,也沒有被移除頻道的任何記憶。
- 若要讓 Claude 遠離某個頻道,請保持該頻道為已設定狀態並將
enabled設為false,而非移除它;或確保它將繼承的內容(移除不會影響這些內容)會讓 Claude 保持關閉。 - 若要讓頻道不儲存任何內容,同時保留其工作階段和記憶,請改為清除每項設定並分離每個 Bundle。
有兩種頻道完全無法在此移除,無論 Claude 在其中開啟或關閉,都會傳回不帶 error_code 的 400:群組私訊,以及包含此 API 未管理之組態的頻道,例如執行器集區或只有 claude.ai 才有的設定。這些會在檢查 enabled 之前先檢查,因此關閉 Claude 也無濟於事;第二種頻道由組織擁有者在 claude.ai 中移除。
client = anthropic.Anthropic()
deleted_channel = client.beta.organization.claude_tag.slack_channels.delete(
"slch_011CZkZmRt4vNq8sHbYw2KdX"
)
print(deleted_channel.id){
"type": "slack_channel_deleted",
"id": "slch_011CZkZmRt4vNq8sHbYw2KdX"
}請求一傳回,該 id 就會傳回 404,其餘內容則在背景中刪除。重複移除會傳回 404,因此如果您在 503 之後重新傳送移除請求,此時的 404 表示該頻道已不存在。
Slack 工作區
工作區物件描述一個 Slack 工作區。它具有與頻道物件相同的欄位,差別在於 type 為 slack_workspace、id 的前綴為 slws_,且 slack 只包含 workspace_id。快速入門的回應展示了一個完整的工作區物件。以 include_inherited=true 讀取時,工作區會顯示由工作區和 Slack 預設值解析出的每項設定,這也是該工作區的頻道所繼承的內容,除非有更近的層級設定了該項設定。
不是有效 slws_ 識別碼的 id 會傳回 400。有效但未指向您組織任何工作區的 id 會傳回 404。
列出工作區
GET /v1/organizations/claude_tag/slack_workspaces 會列出您組織擁有的已設定工作區,依 created_at 由新到舊排序。快速入門展示了請求和回應。若要依 Slack 自己的 ID 尋找單一工作區,請加入 slack_workspace_id:data 會包含該工作區,若它尚未設定則為空,而您的組織未擁有的工作區會傳回 404。您的組織僅透過 Enterprise Grid 擁有的工作區,在設定之前也會傳回 404。加入 include_inherited=true 可讓每個工作區包含其中實際生效的內容(請參閱儲存值與繼承值)。需要 read:claude_tag 範圍。
取得工作區
GET /v1/organizations/claude_tag/slack_workspaces/{id} 會傳回工作區物件,其中包含工作區儲存的內容,或者,如同讀取頻道中實際生效的內容在查詢中使用 include_inherited=true 時,包含其中實際生效的內容。需要 read:claude_tag 範圍。
client = anthropic.Anthropic()
workspace = client.beta.organization.claude_tag.slack_workspaces.retrieve(
"slws_011CZkZnWa7xPc3uJfZe5LgT"
)
print(workspace.settings.instructions)更新工作區
POST /v1/organizations/claude_tag/slack_workspaces/{id} 會變更工作區的設定並傳回工作區物件。settings 為必要項目,並遵循變更設定。您在此處設定的內容會套用於該工作區中每個未設定自己值的頻道,但 instructions 除外,每個頻道會將自己的指示附加上去,而非取代。需要 write:claude_tag 範圍。
client = anthropic.Anthropic()
workspace = client.beta.organization.claude_tag.slack_workspaces.update(
"slws_011CZkZnWa7xPc3uJfZe5LgT",
settings={"guest_policy": {"type": "restrict"}},
)
print(workspace.settings.guest_policy)Bundle
Bundle 就是 claude.ai 中所稱的存取套組:一組具名的存取權限,例如連接器、儲存庫和憑證,Claude 可以在頻道或工作區中使用。組織擁有者在 claude.ai 中建立、編輯和刪除 Bundle。此 API 會列出並附加 Bundle。它會傳回 Bundle 的名稱和說明,但絕不會傳回 Bundle 所授予的內容。
| 欄位 | 說明 |
|---|---|
type | bundle。 |
id | 前綴為 capp_。 |
display_name | Bundle 的名稱。 |
description | Bundle 的用途。若沒有則為 null。 |
created_at、updated_at | Bundle 的建立時間與最後變更時間。 |
不是有效 capp_ 識別碼的 bundle_id 會傳回 400。有效但不存在或屬於其他組織的 bundle_id 會傳回 404,無論請求中還包含什麼。Claude Tag 為自身管理的 Bundle 不會被列出,並會傳回 404。
列出 Bundle
GET /v1/organizations/claude_tag/bundles 會列出您組織的 Bundle,依 created_at 由新到舊排序。需要 read:claude_tag 範圍。
client = anthropic.Anthropic()
bundles = client.beta.organization.claude_tag.bundles.list()
# 視需要自動擷取更多頁面。
for bundle in bundles:
print(f"{bundle.id}: {bundle.display_name}"){
"data": [
{
"type": "bundle",
"id": "capp_011CZkZjLP1cWxj5EtMmdgbq",
"display_name": "Support tools",
"description": "Issue tracker and the support runbooks repository.",
"created_at": "2026-09-12T08:15:30Z",
"updated_at": "2026-09-30T13:02:47Z"
}
],
"next_page": null
}取得 Bundle
GET /v1/organizations/claude_tag/bundles/{bundle_id} 會傳回 Bundle 物件。需要 read:claude_tag 範圍。
client = anthropic.Anthropic()
bundle = client.beta.organization.claude_tag.bundles.retrieve(
"capp_011CZkZjLP1cWxj5EtMmdgbq"
)
print(bundle.display_name)Bundle 目標
Bundle 目標是一個 Bundle 附加到一個頻道或一個工作區的記錄。附加到工作區的 Bundle 可以在該工作區及其中的每個頻道中使用。附加到頻道的 Bundle 只能在該頻道中使用。
| 欄位 | 說明 |
|---|---|
type | slack_channel 或 slack_workspace。 |
id | 前綴為 btgt_。它是路徑中的 {target_id},絕不會是頻道或工作區本身的 id。 |
slack_channel_id | 在 slack_channel 目標上:頻道的 id,前綴為 slch_。 |
slack_workspace_id | 在 slack_workspace 目標上:工作區的 id,前綴為 slws_。 |
created_at | Bundle 的附加時間。 |
一個 Bundle 最多只會附加到某個頻道或工作區一次,而同一組配對永遠具有相同的 id,即使在卸離後重新附加也是如此。id 是不透明的:請從附加操作的回應或清單中取得。Bundle 目標不包含其 Bundle 的 id,而其路徑也需要該 id,因此請將兩者一併保存。
附加或分離不會變更任何已儲存的設定。在頻道或工作區中執行的工作階段會收到其存取權已變更的通知。
claude.ai 在值班(on-call)設定中附加的 Bundle 會被列出且可以讀取,但無法在此附加或卸離;而由值班設定管理的頻道或工作區,也無法在此附加或卸離任何內容。這些請求都會傳回 400。
列出 Bundle 的目標
GET /v1/organizations/claude_tag/bundles/{bundle_id}/targets 會列出該 Bundle 所附加的頻道和工作區,依 created_at 由新到舊排序。需要 read:claude_tag 範圍。
client = anthropic.Anthropic()
targets = client.beta.organization.claude_tag.bundles.targets.list(
"capp_011CZkZjLP1cWxj5EtMmdgbq"
)
# 視需要自動擷取更多頁面。
for target in targets:
print(f"{target.id}: {target.type}"){
"data": [
{
"type": "slack_channel",
"id": "btgt_011CZkZpBv9yQd6wKhAr8MnU1CZkZwPd5fSj8tMxUr3ZcH",
"slack_channel_id": "slch_011CZkZmRt4vNq8sHbYw2KdX",
"created_at": "2026-10-19T16:21:44Z"
},
{
"type": "slack_workspace",
"id": "btgt_011CZkZuMc3dVk7xQpGw9StZ1CZkZxRe6gTk9uNyVs4adJ",
"slack_workspace_id": "slws_011CZkZnWa7xPc3uJfZe5LgT",
"created_at": "2026-09-12T08:17:02Z"
}
],
"next_page": null
}只有附加到頻道和工作區的項目會被列出。在 claude.ai 中附加到其他對象(例如預設 Slack 存取權限)的 Bundle 沒有對應的 Bundle 目標,一次在多個頻道中套用 Bundle 的規則也沒有。因此,Claude 在某個頻道中可使用的 Bundle 可能多於指向該頻道的目標。沒有任何端點會列出附加到單一頻道或工作區的 Bundle。
附加 Bundle
POST /v1/organizations/claude_tag/bundles/{bundle_id}/targets 會附加 Bundle 並傳回 Bundle 目標。請求主體會指定 type 及對應的 id。頻道或工作區必須已經設定完成:附加操作絕不會設定頻道。附加一組已附加的配對會傳回 200 以及現有的 Bundle 目標。需要 write:claude_tag 範圍。
將 Bundle 附加到頻道:
client = anthropic.Anthropic()
target = client.beta.organization.claude_tag.bundles.targets.create(
"capp_011CZkZjLP1cWxj5EtMmdgbq",
target={
"type": "slack_channel",
"slack_channel_id": "slch_011CZkZmRt4vNq8sHbYw2KdX",
},
)
print(target.id){
"type": "slack_channel",
"id": "btgt_011CZkZpBv9yQd6wKhAr8MnU1CZkZwPd5fSj8tMxUr3ZcH",
"slack_channel_id": "slch_011CZkZmRt4vNq8sHbYw2KdX",
"created_at": "2026-10-19T16:21:44Z"
}將 Bundle 附加到工作區:
client = anthropic.Anthropic()
target = client.beta.organization.claude_tag.bundles.targets.create(
"capp_011CZkZjLP1cWxj5EtMmdgbq",
target={
"type": "slack_workspace",
"slack_workspace_id": "slws_011CZkZnWa7xPc3uJfZe5LgT",
},
)
print(target.id)附加到頻道的項目具有套用條件,例如僅在頻道中沒有 Slack 訪客時才套用。條件是在 claude.ai 中設定的,不會在此傳回。透過此 API 附加時會使用預設條件,而附加一組已附加的配對則會保持其條件不變。
取得 Bundle 目標
GET /v1/organizations/claude_tag/bundles/{bundle_id}/targets/{target_id} 會傳回 Bundle 目標。不是有效 btgt_ 識別碼的 target_id 會傳回 400。有效但屬於其他 Bundle、已被分離,或指向已不再設定之頻道或工作區的 target_id 會傳回 404。需要 read:claude_tag 範圍。
client = anthropic.Anthropic()
target = client.beta.organization.claude_tag.bundles.targets.retrieve(
"btgt_011CZkZpBv9yQd6wKhAr8MnU1CZkZwPd5fSj8tMxUr3ZcH",
bundle_id="capp_011CZkZjLP1cWxj5EtMmdgbq",
)
print(target.type)卸離 Bundle
DELETE /v1/organizations/claude_tag/bundles/{bundle_id}/targets/{target_id} 會分離 Bundle。重複分離會傳回 404,因此在 503 之後,重新傳送的分離請求若傳回 404,表示該 Bundle 目標已不存在。需要 write:claude_tag 範圍。
client = anthropic.Anthropic()
deleted_target = client.beta.organization.claude_tag.bundles.targets.delete(
"btgt_011CZkZpBv9yQd6wKhAr8MnU1CZkZwPd5fSj8tMxUr3ZcH",
bundle_id="capp_011CZkZjLP1cWxj5EtMmdgbq",
)
print(deleted_target.id){
"type": "bundle_target_deleted",
"id": "btgt_011CZkZpBv9yQd6wKhAr8MnU1CZkZwPd5fSj8tMxUr3ZcH"
}無法識別的值
guest_policy.type、來源的 type、Bundle 目標的 type 以及錯誤代碼隨時可能新增值。請將無法識別的值視為任何未知字串來處理,而不是讓程式失敗。
速率限制
請求依每個組織進行限制,分為兩個預算,由您組織的所有金鑰共用,且與您組織的其他 Admin API 限制分開。每個預算允許突發請求,之後以穩定的速率補充:
| 預算 | 請求 | 突發量 | 補充速率 |
|---|---|---|---|
| 讀取 | 每個 GET | 120 | 每秒 2 個 |
| 變更 | 每個 POST 和 DELETE | 60 | 每秒 1 個 |
超出預算的請求會傳回 429 Too Many Requests,並帶有 retry-after 標頭:請等待該秒數後再次傳送請求。已到達其預算階段的請求,無論結果為何,都會取得該預算的 anthropic-ratelimit-requests-limit、anthropic-ratelimit-requests-remaining 和 anthropic-ratelimit-requests-reset 標頭;在此之前就被拒絕的請求(例如因其金鑰、範圍或標頭,或因您的組織未啟用此 API、變更或新儲存空間)則不會取得任何這些標頭。
分頁
列表端點使用「opaque cursor」(不透明游標)。第一個請求最多傳回 limit 列資料以及一個 next_page 游標;請在下一個請求中將該游標原封不動地作為 page 參數傳入,其他查詢參數維持不變,並重複此步驟直到 next_page 為 null。與傳回該游標之請求使用不同 include_inherited 值一起傳送的游標會傳回 400。請將游標字串視為不透明:不要自行剖析、修改或建構它。列出頻道可能會傳回少於 limit 個頻道甚至沒有頻道的頁面,但 next_page 仍有值,因此請持續請求頁面,直到 next_page 為 null。Python、TypeScript、C#、Go、Java 和 Ruby SDK 的列表迭代器以及 CLI(使用 --format raw 時除外)會替您處理這件事。在 PHP 和 curl 中,請自行請求每一頁,並將其 next_page 作為 page 傳入。
limit 預設為 20,最小值為 1,最大值為 100;超出該範圍的值在每個列表上都會傳回 400。每個列表都依 created_at 由新到舊排序,且不接受其他排序方式。
錯誤回應
錯誤回應遵循 Claude API 錯誤中記載的標準格式。聯絡支援團隊時,請提供回應主體中的 request_id。
| 狀態 | 意義 |
|---|---|
| 400 | 輸入無效,或該操作不適用於此頻道、工作區或 Bundle(請參閱各端點的章節)。 |
| 401 | 缺少 x-api-key 標頭,或無法辨識該金鑰。 |
| 403 | 該金鑰不是組織層級的具範圍金鑰、缺少所需的範圍,或您的組織無法進行此變更。 |
| 404 | 找不到資源,或資源不屬於您的組織。當請求省略 anthropic-beta 值,或您的組織未啟用此 API 時,也會傳回此狀態,使端點看起來不存在。 |
| 409 | 在請求執行期間,有其他操作變更或移除了該資源。請求所要求的內容都未執行:未儲存任何設定,也未附加、分離或移除任何內容。唯一的例外是設定請求,它可能在其 settings 遇到衝突(slack_channel_set_up_settings_conflict)之前就已設定了頻道。請重新讀取資源,若仍需要則重新傳送請求。 |
| 429 | 超出速率限制。請參閱速率限制。 |
| 500 | 內部錯誤。 |
| 503 | 暫時性錯誤。對於變更操作,它不會說明變更是否已儲存。每項變更都可安全重複,因此請原封不動地再次傳送請求。如果重新傳送的 DELETE 隨後傳回 404,表示該頻道或 Bundle 目標已不存在。 |
當同一個狀態有多種您會以不同方式處理的原因時,錯誤中也會包含 error.details.error_code:
{
"type": "error",
"error": {
"type": "invalid_request_error",
"message": "...",
"details": {
"error_code": "slack_channel_set_up_settings_refused",
"slack_channel_id": "slch_011CZkZmRt4vNq8sHbYw2KdX"
}
},
"request_id": "req_018EeWyXxfu5pfWkrYcMdjWG"
}error_code | 狀態 | 意義及處理方式 |
|---|---|---|
organization_level_scoped_api_key_required | 403 | 該憑證不是屬於整個組織的具範圍 Admin API 金鑰。請向您的主要擁有者索取。 |
api_key_scope_missing | 403 | 該金鑰缺少端點所需的 read:claude_tag 或 write:claude_tag。 |
claude_tag_writes_not_enabled | 403 | 您的組織可以透過此 API 讀取,但未啟用變更功能。 |
compliance_configuration_restricted | 403 | 您的組織具有合規組態,在此組態下 Claude Tag 不會儲存任何新內容,例如零資料保留。設定頻道、更新設定(即使是清除設定)以及附加 Bundle 都會被拒絕。分離 Bundle 和移除頻道則不會被拒絕,且此類組織即使在 Claude 於頻道中開啟時,也可以移除該頻道。 |
environment_not_found | 404 | environment_id 未指向您的組織可在此使用的任何環境。路徑中的 id 沒有問題。 |
environment_archived | 400 | environment_id 指向已封存的環境。 |
slack_channel_set_up_settings_refused | 400 | 請求設定了頻道,隨後 settings 被拒絕。details.slack_channel_id 為該頻道。請參閱設定頻道。 |
slack_channel_set_up_environment_not_found | 404 | 請求設定了頻道,隨後找不到 environment_id。details.slack_channel_id 為該頻道。請參閱設定頻道。 |
slack_channel_set_up_settings_conflict | 409 | 請求設定了頻道,隨後另一項變更與 settings 重疊。settings 的任何內容都未被儲存。details.slack_channel_id 為該頻道。請參閱設定頻道。 |
slack_channel_enabled | 400 | Claude 在該頻道中為開啟狀態(enabled 解析為 true),因此無法移除。請先將 enabled 設為 false。請參閱移除頻道。 |
未來可能會新增代碼。對於您無法辨識的代碼,請依其狀態處理。不含 error_code 的 404 有兩種原因之一。一是找不到請求所指定的內容(路徑中的 id,或主體或查詢中的 Slack 頻道或工作區),二是因為請求省略了 anthropic-beta 值或您的組織未啟用此 API,導致每個端點看起來都不存在。若要區分兩者,請使用相同的金鑰和標頭列出您的工作區:該請求未指定任何內容,因此只有在第二種情況下才會傳回 404。
Activity Feed 事件
透過此 API 進行的每項變更都會記錄在您組織的 Compliance API Activity Feed 上,並歸屬於該 API 金鑰,以帶有其 apikey_ ID 的 api_actor 表示。這些事件與在 claude.ai 中進行相同變更時 Activity Feed 所記錄的事件相同,因此無論變更是以何種方式進行,一次查詢即可找到。
| 事件 | 發出時機 |
|---|---|
ccr_agent_created | 頻道被設定時。 |
ccr_agent_updated | 頻道或工作區上的設定變更時。 |
ccr_agent_deleted | 頻道被移除時。其 Bundle 目標會一併移除,且不會發出各自的事件。 |
ccr_agent_proxy_profile_bound | Bundle 被附加時。 |
ccr_agent_proxy_profile_unbound | Bundle 被分離時。 |
這些事件以動態消息自己的識別碼 agent_id(前綴為 cagt_)指名頻道或工作區,而此 API 的任何回應都不包含該識別碼,因此您目前還無法將事件對應到頻道或工作區的 id。兩個 Bundle 事件在 profile_id 中指名 Bundle,並在 scope_id 中以相同的 agent_id 指名頻道或工作區。
ccr_agent_updated 事件會在 updated_fields 中列出變更的項目,並使用 Activity Feed 自己的名稱:
| 設定 | 在 updated_fields 中的名稱 |
|---|---|
enabled | slackbot_version |
instructions | system_prompt_addendum |
model | default_model |
environment_id | default_environment_id |
guest_policy | guest_policy |
updated_fields 也可能包含 is_virtual,它不代表任何設定。當透過此 API 進行的變更是任何人在頻道或工作區上儲存的第一項內容時,它會出現在該事件中已變更設定的名稱旁:此類頻道或工作區包括由 Claude 的首次使用所設定的頻道、由此 API 在沒有 settings 的情況下設定的頻道,或從未使用過 Claude 的工作區,且沒有人在此處或 claude.ai 中於其上儲存過設定或附加過 Bundle。程式碼頻道開始時使用的 model 不算作已儲存。附加 Bundle 只會記錄 ccr_agent_proxy_profile_bound。
讀取、未變更任何內容的請求,以及在儲存任何內容之前即被拒絕的請求,都不會記錄任何事件。若設定請求設定了一個頻道,但其 settings 隨後被拒絕,則會記錄 ccr_agent_created。
另請參閱
您的主要擁有者在此建立具範圍限制的金鑰。
Claude Tag 是什麼、如何設定,以及每項設定在 Slack 中的作用。
在此處及 claude.ai 中所做每項變更的稽核軌跡。
管理您 Claude Enterprise 組織中的外掛程式。
這個頁面有幫助嗎?