Claude Tag API

Claude Tag ist Claude, das als Teammitglied in Slack arbeitet: Jemand erwähnt Claude in einem Kanal, und Claude antwortet im Thread. Mit der Claude Tag API kannst du aus deinen eigenen Systemen die Claude Tag-Einstellungen lesen und ändern, die ein Organisationseigentümer sonst manuell unter claude.ai > Organization settings > Claude Tag festlegt. Verwende sie, um Claude Kanal für Kanal über einen Genehmigungs-Workflow einzuschalten, deine Konfiguration in der Versionskontrolle zu halten oder zu prüfen, was in jedem Kanal gilt.

Claude Tag ist ein claude.ai-Produkt. Diese API verwaltet es für eine Claude Enterprise-Organisation und hat nichts mit Claude Platform-Workspaces, API-Nutzung oder der Claude Console zu tun.

Endpunkte

Die API stellt 18 Endpunkte für fünf Ressourcen bereit:

Dieses Release umfasst Slack. Das Verbinden und Trennen eines Slack-Workspace, das Erstellen und Bearbeiten von Access Bundles, Ausgabenlimits und jede Claude Tag-Einstellung außer den fünf unter Einstellungen bleiben in claude.ai.

Voraussetzungen

• Deine Organisation muss einen Claude Enterprise-Plan haben, mit eingerichtetem Claude Tag und mindestens einem verbundenen Slack-Workspace.
• Dein primärer Eigentümer erstellt unter claude.ai > Organization settings > API einen Admin-API-Key mit dem Scope read:claude_tag, dem Scope write:claude_tag oder beiden. Siehe Einen Admin-API-Key erstellen.
• Jede Anfrage enthält drei Header: x-api-key, anthropic-version: 2023-06-01 und anthropic-beta: claude-tag-2026-09-28.

Die SDKs für Python, TypeScript, C#, Go, Java, PHP und Ruby stellen diese Endpunkte unter client.beta.organization.claude_tag bereit und die ant CLI unter ant beta:organization:claude-tag; sie senden die Header anthropic-version und anthropic-beta für dich. Die Beispiele auf dieser Seite verwenden den Standard-Client jedes SDK, der, wie die CLI, den Admin-API-Key aus der Umgebungsvariable ANTHROPIC_API_KEY liest; die curl-Beispiele lesen den Key aus derselben Variable und übergeben ihn im Header x-api-key. Wenn ein SDK oder die CLI weitere Seiten für dich abruft, legt limit die Seitengröße fest, nicht die Gesamtzahl (siehe Paginierung).

API-Keys gehören der Organisation und funktionieren weiter, nachdem die Person, die sie erstellt hat, die Organisation verlässt. Teile sie nicht und checke sie nicht in die Versionskontrolle ein.

Schnellstart

Liste die Slack-Workspaces auf, die deine Organisation mit Claude Tag verbunden hat:

client = anthropic.Anthropic()

workspaces = client.beta.organization.claude_tag.slack_workspaces.list()

# Ruft bei Bedarf automatisch weitere Seiten ab.
for workspace in workspaces:
    print(f"{workspace.id}: {workspace.slack.team_id}")

{
  "data": [
    {
      "type": "slack_workspace",
      "id": "slws_011CZkZnWa7xPc3uJfZe5LgT",
      "slack": {
        "team_id": "T01ABCD2EFG"
      },
      "settings": {
        "enabled": null,
        "instructions": "Answer in English unless asked otherwise.",
        "model": null,
        "environment_id": null,
        "guest_policy": null
      },
      "agent_id": "cagt_011CZkZrFy4aSg8uMkDt9PqW",
      "created_at": "2026-09-02T17:04:11Z",
      "updated_at": "2026-10-06T09:41:53Z"
    }
  ],
  "next_page": null
}

Eine Einstellung, die null ist, ist für diesen Workspace nicht gesetzt, sodass der Workspace sie erbt. Siehe Gespeicherte und effektive Einstellungen.

Scopes

Ein Key kann beide Scopes haben. Eine Integration, die einen Kanal nachschlägt und ihn dann ändert, benötigt beide. Kein anderer Scope gewährt Zugriff auf diese Endpunkte.

Der Key muss der Organisation als Ganzes gehören. Die Organisation ist immer diejenige, der der Key gehört, und keine Anfrage benennt eine. Eine Anfrage, die den Header anthropic-workspace-id sendet, gibt 400 zurück, da nichts hier zu einem Claude Platform-Workspace gehört.

Wichtige Konzepte

Bezeichnungen auf dieser Seite und in claude.ai

Eingerichtete Kanäle und Workspaces

Ein Kanal oder Workspace ist eingerichtet („set up“), wenn Claude Tag einen Einstellungsdatensatz für ihn führt. Nur ein eingerichteter Kanal oder Workspace hat eine id, und nur diese werden aufgelistet: Slack, nicht diese API, führt die vollständige Liste der Kanäle eines Workspace.

• Ein Workspace wird eingerichtet, wenn ein Organisationseigentümer ihn in claude.ai verbindet. Kein Endpunkt richtet einen Workspace ein oder entfernt ihn.
• Ein Kanal wird in claude.ai, durch Claudes erste Nutzung darin oder mit Einen Kanal einrichten eingerichtet.
• Die Slack-Standardeinstellungen werden eingerichtet, wenn jemand Claude Tag zum ersten Mal einrichtet: Ein Eigentümer verbindet einen Slack-Workspace, oder ein Mitglied meldet sich bei Claude in Slack an oder nutzt es zum ersten Mal.

Deine Organisation besitzt einen Workspace, solange seine Verbindung aktiv ist, und besitzt die Kanäle darin. Ein Kanal oder Workspace, den du nicht besitzt, gibt dasselbe 404 zurück wie einer, der nicht existiert.

IDs

Du kennst einen Kanal anhand der IDs, die Slack dir anzeigt. Schlage seine id einmal mit Einen Kanal anhand seiner Slack-IDs finden nach, speichere dann die id und verwende sie.

Eine id ändert sich nicht, solange der Kanal oder Workspace eingerichtet ist, egal was du daran änderst, mit einer Ausnahme, die unter Schreibgeschützter Modus beschrieben ist. Ein Kanal oder Workspace, der entfernt und erneut eingerichtet wird, hat eine neue id, und die alte gibt weiterhin 404 zurück. Wenn eine gespeicherte id 404 ohne error_code zurückgibt, rufe die Slack-Standardeinstellungen ab mit demselben Key und denselben Headern. Diese Anfrage benennt keinen Kanal und keinen Workspace, daher bedeutet jeder andere Status als 404, dass die id nicht mehr existiert: Suche den Kanal oder Workspace erneut anhand seiner Slack-IDs. Ein 404 auch dort sagt nichts über die id aus: Behalte deine gespeicherten id-Werte und sieh dir Fehlerantworten an.

agent_id (mit dem Präfix cagt_) ist die Bezeichnung, mit der die Compliance API denselben Kanal oder Workspace benennt, sowohl als Eigentümer der Sitzungen, die Claude dort ausgeführt hat, als auch in Activity Feed-Ereignissen. Sie besteht so lange wie die id.

Einstellungen

Jede Einstellungsebene speichert dieselben fünf Einstellungen, alle optional:

model und environment_id werden beim Schreiben geprüft und danach nicht erneut: Wenn sich das Modell oder die Umgebung später ändert, geben beide Ansichten weiterhin den gespeicherten Wert zurück.

Wenn ein Organisationseigentümer eine Einstellungsebene in claude.ai auf einen selbst gehosteten Runner-Pool gesetzt hat, gibt ihre environment_id die ID des Pools zurück, die mit ccpool_ beginnt. Diese API kann keinen Runner-Pool festlegen und gibt 400 für eine Anfrage zurück, die environment_id auf einer Einstellungsebene ändert oder löscht, die einen speichert.

Gespeicherte und effektive Einstellungen

Einstellungen existieren auf drei Ebenen: dem Kanal, dem Workspace, in dem sich der Kanal befindet, und den Slack-Standardeinstellungen deiner Organisation. Jede Ebene speichert nur, was auf ihr festgelegt wurde. Die API bietet dir zwei Ansichten:

• Die gespeicherte Ansicht („stored“) (Einen Kanal abrufen, Einen Workspace abrufen) enthält, was der Kanal oder Workspace selbst speichert. Eine Einstellung, die dort nicht gesetzt ist, ist null. Verwende sie zum Abgleich mit einer Konfiguration, die du anderswo führst.
• Die effektive Ansicht („effective“) (Die effektiven Einstellungen eines Kanals abrufen, Die effektiven Einstellungen eines Workspace abrufen) enthält, was gilt, sobald jede Ebene berücksichtigt ist, und sources benennt die Ebene, aus der jeder Wert stammt. Verwende sie zur Prüfung oder um herauszufinden, warum Claude sich in einem Kanal so verhält, wie es sich verhält.

Jede Einstellung wird für sich aufgelöst:

Beispielsweise speichert eine Organisation Anweisungen in ihren Slack-Standardeinstellungen, schaltet Claude für einen Workspace aus und legt ein Modell für einen Kanal dieses Workspace fest. Die effektive Ansicht des Kanals zeigt die drei Werte und woher jeder stammt:

{
  "type": "slack_channel_effective",
  "id": "slch_011CZkZmRt4vNq8sHbYw2KdX",
  "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_defaults" }],
    "model": {
      "type": "slack_channel",
      "slack_channel_id": "slch_011CZkZmRt4vNq8sHbYw2KdX"
    },
    "environment_id": { "type": "default" },
    "guest_policy": { "type": "default" }
  }
}

Eine Quelle ist eine der folgenden:

sources.instructions ist eine Liste, die umfassendste zuerst, aller Ebenen, die Text beitragen, und ist leer, wenn keine dies tut. Die ID einer Quelle kann null sein in einer Organisation, die den Kanal über eine Slack Enterprise Grid-Verbindung statt über den eigenen Workspace des Kanals erreicht.

Einstellungen ändern

Die drei Update-Endpunkte und Einen Kanal einrichten nehmen ein settings-Objekt nach denselben Regeln entgegen:

• Eine Einstellung, die du weglässt, bleibt unverändert. {"settings": {"enabled": false}} schaltet Claude aus und lässt die anderen vier Einstellungen, wie sie sind.
• Eine Einstellung, die du als null sendest, wird gelöscht, sodass die Ebene sie wieder erbt.
• Alles oder nichts. Wenn ein Wert in einer Anfrage abgelehnt wird, wird keine Einstellung der Anfrage gespeichert.
• Gefahrlos wiederholbar. Jede Änderung hinterlässt die Ressource so, wie die erste identische Anfrage sie hinterlassen hat, daher nimmt kein Endpunkt einen Idempotency-Key entgegen. Eine Anfrage, die nichts ändert, schreibt nichts und zeichnet kein Activity Feed-Ereignis auf.
• Der letzte Schreibvorgang gewinnt. Keine Anfrage nimmt eine Vorbedingung entgegen. Zwei Aufrufer, die jeweils eine Ressource lesen und dann dieselbe Einstellung ändern, überschreiben sich gegenseitig. Ein 409 wird nur zurückgegeben, wenn sich eine andere Änderung mit deiner Anfrage überschneidet, während diese läuft; nichts von deiner Anfrage wurde gespeichert, also lies die Ressource erneut und sende die Änderung noch einmal, falls sie noch benötigt wird.

Eine Änderung von guest_policy für einen Kanal kann Sitzungen beenden, die in diesem Kanal laufen. Sie enden im Hintergrund, und die Antwort wartet nicht darauf.

Konfigurierte Ebenen

Eine Einstellungsebene ist konfiguriert („configured“), sobald eine Person oder ein Key eine Einstellung auf ihr geändert oder ein Bundle an sie angehängt hat. Sie bleibt von da an konfiguriert, selbst nachdem jede Einstellung gelöscht und jedes Bundle getrennt wurde. Ein Kanal, der durch Claudes erste Nutzung oder über diese API ohne Einstellung eingerichtet wurde, ist erst nach seiner ersten Änderung oder seinem ersten Bundle konfiguriert. Dies ist an zwei Stellen wichtig: Nur ein konfigurierter Kanal kann entfernt werden, und nur ein Kanal, der nicht konfiguriert ist, kann eine neue id erhalten (siehe Schreibgeschützter Modus).

Schreibgeschützter Modus

API / Terraform read-only mode (schreibgeschützter Modus) ist eine Einstellung, die ein Organisationseigentümer in den Claude Tag-Einstellungen von claude.ai ein- und ausschaltet. Der Name beschreibt claude.ai und Slack: Solange der Modus eingeschaltet ist, lehnen sie Änderungen einer Person an dem ab, was diese API verwaltet, sodass nur Keys diese Änderungen vornehmen. Er macht diese API nicht schreibgeschützt. Jeder Endpunkt auf dieser Seite antwortet gleich, ob der Modus ein- oder ausgeschaltet ist, und kein Endpunkt liest oder ändert ihn.

Solange der Modus ausgeschaltet ist, ändern Personen und Keys dieselben Einstellungen und hängen dieselben Bundles an und trennen sie, und jede Änderung ersetzt, was gespeichert ist. Schalte ihn ein, wenn deine Pipeline die einzige Quelle von Änderungen sein soll.

Solange der Modus eingeschaltet ist, lehnen claude.ai und Slack Folgendes ab:

• Das Ändern einer der fünf Einstellungen für einen Kanal, einen Workspace oder die Slack-Standardeinstellungen.
• Das Einrichten eines Kanals, das Entfernen eines Kanals oder das Trennen eines Workspace in claude.ai.
• Das Anhängen eines Bundles an einen Kanal oder Workspace, das Trennen eines Bundles oder das Löschen eines Bundles, das an einen angehängt ist.

Einige Dinge bleiben in beiden Fällen möglich: Ein Eigentümer kann weiterhin einen neuen Workspace verbinden, Bundles erstellen und bearbeiten und Claude Tag-Einstellungen ändern, die diese API nicht verwaltet. Claudes erste Nutzung richtet weiterhin einen Kanal ein, das Löschen eines Kanals in Slack entfernt ihn weiterhin, und das Deinstallieren von Claudes Slack-App trennt diesen Workspace weiterhin.

Solange der Modus ausgeschaltet ist, kann das Einrichten eines Kanals in claude.ai, der bereits eingerichtet und nicht konfiguriert ist, den Datensatz des Kanals ersetzen. Der Kanal hat dann eine neue id und agent_id, und die alte id gibt 404 zurück. Die id eines konfigurierten Kanals besteht, bis der Kanal entfernt wird.

Gruppen-Direktnachrichten

Eine Slack-Gruppen-Direktnachricht hat eine ID in der Form einer Kanal-ID, daher richtet Claudes Nutzung darin sie wie einen Kanal ein: Sie hat eine id, wird aufgelistet und kann gelesen werden. Das Einrichten einer solchen über diese API, das Ändern einer Einstellung für sie und das Anhängen eines Bundles an sie geben jeweils 400 zurück. Das Trennen eines Bundles von ihr ist erlaubt.

Beispiel-Workflows

Claude nur in genehmigten Kanälen einschalten

Jedes Mitglied kann Claude in einen öffentlichen Kanal einladen. Um Claude nur dort eingeschaltet zu lassen, wo du es genehmigt hast:

1. Schalte Claude überall aus, indem du enabled in den Slack-Standardeinstellungen auf false setzt.
2. Wenn dein Genehmigungssystem einen Kanal genehmigt, richte den Kanal ein mit "settings": {"enabled": true}. Die Anfrage nimmt Slacks eigene IDs entgegen und gibt den Kanal zurück, unabhängig davon, ob er bereits eingerichtet war, daher kann sie gefahrlos wiederholt werden.
3. Hänge im selben Durchlauf die Bundles an, die für das Team genehmigt wurden, damit die erste Sitzung des Kanals bereits ihre Tools hat.

Konfiguration in der Versionskontrolle halten

1. Verwende die IDs, die Slack für jeden Kanal anzeigt, als Schlüssel deiner Konfiguration und finde jeden Kanal anhand dieser IDs.
2. Vergleiche die gespeicherte Ansicht mit dem, was dein Repository deklariert. Die effektive Ansicht würde auch geerbte Werte enthalten.
3. Sende nur die Einstellungen, die sich unterscheiden, und sende null für eine Einstellung, die dein Repository nicht mehr deklariert.
4. Bitte einen Organisationseigentümer, den schreibgeschützten Modus einzuschalten, damit niemand dieselben Einstellungen manuell ändert.

Prüfen, was überall gilt

1. Liste deine Workspaces auf und dann die Kanäle jedes Workspace.
2. Lies die effektiven Einstellungen jedes Kanals und markiere, was deine Richtlinie verbietet, etwa einen Kanal, in dem enabled ohne hinterlegte Genehmigung true ist, oder in dem guest_policy allow ist.
3. Liste deine Bundles auf und dann die Ziele jedes Bundles, um zu sehen, wo Zugriff auf sensible Systeme angehängt ist.

Slack-Kanäle

Das Kanal-Objekt ist die gespeicherte Ansicht eines Slack-Kanals:

Eine id ohne das Präfix slch_ gibt 400 zurück. Eine id, die das Präfix trägt, aber keinen Kanal deiner Organisation benennt, gibt 404 zurück.

Einen Kanal einrichten

POST /v1/organizations/claude_tag/slack_channels richtet einen Slack-Kanal ein und gibt ihn zurück. slack.team_id und slack.channel_id sind erforderlich und sind Slacks eigene IDs. settings ist optional und folgt den Regeln unter Einstellungen ändern. Wenn der Kanal bereits eingerichtet ist, gibt die Anfrage den vorhandenen Kanal zurück und wendet settings an; die Antwort ist in beiden Fällen 200. Erfordert den Scope write:claude_tag.

client = anthropic.Anthropic()

channel = client.beta.organization.claude_tag.slack_channels.create(
    slack={"team_id": "T01ABCD2EFG", "channel_id": "C05HJKL6MNP"},
    settings={"instructions": "Answer in the language of the question."},
)

print(channel.id)

{
  "type": "slack_channel",
  "id": "slch_011CZkZmRt4vNq8sHbYw2KdX",
  "slack": {
    "team_id": "T01ABCD2EFG",
    "channel_id": "C05HJKL6MNP"
  },
  "settings": {
    "enabled": null,
    "instructions": "Answer in the language of the question.",
    "model": null,
    "environment_id": null,
    "guest_policy": null
  },
  "agent_id": "cagt_011CZkZsHz6bTh2vNmEu4QrX",
  "created_at": "2026-10-19T16:20:05Z",
  "updated_at": "2026-10-19T16:20:05Z"
}

Bevor ein Kanal eingerichtet wird, vergewissert sich Claudes Slack-App bei Slack, dass sich der Kanal im Workspace befindet, nicht archiviert ist und für die App sichtbar ist. Ein Kanal, der diese Prüfung nicht besteht, gibt 404 zurück, ebenso wie ein Workspace, in dem Claudes Slack-App nicht installiert ist.

Das Einrichten des Kanals und das Anwenden von settings sind zwei Schritte. Wenn der erste erfolgreich ist und der zweite abgelehnt wird, ist die Antwort die Ablehnung, und der Kanal bleibt eingerichtet, ohne dass etwas gespeichert ist. Diese Ablehnung enthält einen error_code, der mit slack_channel_set_up_ beginnt, und die id des neuen Kanals in error.details.slack_channel_id (siehe Fehlerantworten). Korrigiere settings und sende es in einem Update an diese id, oder sende die Einrichtungsanfrage erneut.

Kanäle auflisten

GET /v1/organizations/claude_tag/slack_channels listet die eingerichteten Kanäle eines Workspace auf, die neuesten zuerst nach created_at. slack_team_id ist erforderlich und ist Slacks eigene ID für den Workspace. Eine Seite kann weniger als limit Kanäle oder gar keine enthalten, während next_page noch gesetzt ist, also fordere weiter Seiten an, bis next_page null ist (siehe Paginierung). Erfordert den Scope read:claude_tag.

client = anthropic.Anthropic()

channels = client.beta.organization.claude_tag.slack_channels.list(
    slack_team_id="T01ABCD2EFG"
)

# Ruft bei Bedarf automatisch weitere Seiten ab.
for channel in channels:
    print(f"{channel.id}: {channel.slack.channel_id}")

Die Antwort ist {"data": [...], "next_page": ...}, wobei jedes Element ein Kanal-Objekt ist. Eine slack_team_id, die einen Workspace benennt, den deine Organisation nicht besitzt, gibt 404 zurück.

Einen Kanal anhand seiner Slack-IDs finden

Füge slack_channel_id, Slacks eigene ID für den Kanal, hinzu, um einen Kanal nachzuschlagen. data enthält diesen Kanal oder ist leer, wenn der Kanal nicht eingerichtet ist. Eine Suche ignoriert limit und page, und ihr next_page ist null. So findest du die id eines Kanals.

client = anthropic.Anthropic()

page = client.beta.organization.claude_tag.slack_channels.list(
    slack_team_id="T01ABCD2EFG",
    slack_channel_id="C05HJKL6MNP",
)

for channel in page.data:
    print(channel.id)

Die Übergabe einer slch_-ID als slack_channel_id gibt 400 zurück.

Einen Kanal abrufen

GET /v1/organizations/claude_tag/slack_channels/{id} gibt das Kanal-Objekt zurück. Erfordert den Scope read:claude_tag.

client = anthropic.Anthropic()

channel = client.beta.organization.claude_tag.slack_channels.retrieve(
    "slch_011CZkZmRt4vNq8sHbYw2KdX"
)

print(channel.settings.enabled)

Einen Kanal aktualisieren

POST /v1/organizations/claude_tag/slack_channels/{id} ändert die Einstellungen des Kanals und gibt das Kanal-Objekt zurück. settings ist erforderlich und folgt den Regeln unter Einstellungen ändern. Erfordert den Scope write:claude_tag.

Schalte Claude in einem Kanal aus und lass seine anderen Einstellungen, wie sie sind:

client = anthropic.Anthropic()

channel = client.beta.organization.claude_tag.slack_channels.update(
    "slch_011CZkZmRt4vNq8sHbYw2KdX",
    settings={"enabled": False},
)

print(channel.settings.enabled)

Lösche die Anweisungen des Kanals, sodass nur die geerbten gelten:

client = anthropic.Anthropic()

channel = client.beta.organization.claude_tag.slack_channels.update(
    "slch_011CZkZmRt4vNq8sHbYw2KdX",
    settings={"instructions": None},
)

print(channel.settings.instructions)

Die effektiven Einstellungen eines Kanals abrufen

GET /v1/organizations/claude_tag/slack_channels/{id}/effective gibt zurück, was im Kanal gilt und woher jeder Wert stammt. Gespeicherte und effektive Einstellungen zeigt eine vollständige Antwort. In dieser Ansicht sind enabled und guest_policy nie null. Die Ansicht wird bei jedem Lesevorgang aufgelöst, daher hat sie kein created_at oder updated_at. Wenn eine Ebene nicht gelesen werden kann, schlägt die Anfrage mit 503 fehl, statt ohne sie aufgelöst zu werden. Erfordert den Scope read:claude_tag.

client = anthropic.Anthropic()

effective = client.beta.organization.claude_tag.slack_channels.effective.retrieve(
    "slch_011CZkZmRt4vNq8sHbYw2KdX"
)

print(effective.settings.instructions)

Einen Kanal entfernen

DELETE /v1/organizations/claude_tag/slack_channels/{id} entfernt einen Kanal aus Claude Tag. Es ist dieselbe Entfernung, die ein Organisationseigentümer in claude.ai vornimmt, mit derselben Wirkung. Der Kanal in Slack oder eine Nachricht darin wird dabei weder gelöscht, archiviert noch verändert. Erfordert den Scope write:claude_tag.

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"
}

Die id gibt 404 zurück, sobald die Anfrage zurückkehrt, und der Rest wird im Hintergrund gelöscht. Ein wiederholtes Entfernen gibt 404 zurück.

Das Entfernen eines Kanals stoppt Claude darin nicht. Claude antwortet weiterhin gemäß dem, was der Kanal erbt, ohne Erinnerung an den Kanal, und bei der nächsten Nutzung kann der Kanal mit einer neuen id erneut eingerichtet werden.

• Um zu verhindern, dass Claude in einem Kanal antwortet, setze stattdessen enabled für ihn auf false.
• Damit ein Kanal nichts speichert und seine Sitzungen und sein Gedächtnis behält, lösche stattdessen jede Einstellung und trenne jedes Bundle.

Zwei Arten von Kanälen können hier nicht entfernt werden und geben 400 zurück: einer, der nicht konfiguriert ist (error_code: "slack_channel_not_configured"), und einer, der Konfiguration enthält, die diese API nicht verwaltet, etwa einen Runner-Pool oder eine Einstellung, die nur claude.ai hat. Ein Organisationseigentümer entfernt die zweite Art in claude.ai.

Slack-Workspaces

Das Workspace-Objekt ist die gespeicherte Ansicht eines Slack-Workspace. Es hat dieselben Felder wie das Kanal-Objekt, außer dass type den Wert slack_workspace hat, id das Präfix slws_ trägt und slack nur team_id enthält. Die Antwort im Schnellstart zeigt ein vollständiges Objekt.

Eine id ohne das Präfix slws_ gibt 400 zurück. Eine id, die das Präfix trägt, aber keinen Workspace deiner Organisation benennt, gibt 404 zurück.

Workspaces auflisten

GET /v1/organizations/claude_tag/slack_workspaces listet die eingerichteten Workspaces auf, die deiner Organisation gehören, die neuesten zuerst nach created_at. Der Schnellstart zeigt die Anfrage und die Antwort. Um einen Workspace anhand von Slacks eigener ID zu finden, füge slack_team_id hinzu: data enthält diesen Workspace oder ist leer, wenn er nicht eingerichtet ist, und ein Workspace, der nicht deiner Organisation gehört, gibt 404 zurück. Erfordert den Scope read:claude_tag.

Einen Workspace abrufen

GET /v1/organizations/claude_tag/slack_workspaces/{id} gibt das Workspace-Objekt zurück. Erfordert den Scope read:claude_tag.

client = anthropic.Anthropic()

workspace = client.beta.organization.claude_tag.slack_workspaces.retrieve(
    "slws_011CZkZnWa7xPc3uJfZe5LgT"
)

print(workspace.settings.instructions)

Einen Workspace aktualisieren

POST /v1/organizations/claude_tag/slack_workspaces/{id} ändert die Einstellungen des Workspace und gibt das Workspace-Objekt zurück. settings ist erforderlich und folgt den Regeln unter Einstellungen ändern. Was du hier festlegst, gilt in jedem Kanal des Workspace, der keinen eigenen Wert festlegt. Erfordert den Scope 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)

Die effektiven Einstellungen eines Workspace abrufen

GET /v1/organizations/claude_tag/slack_workspaces/{id}/effective gibt zurück, was im Workspace gilt, aufgelöst aus dem Workspace und den Slack-Standardeinstellungen, in der Form, die Gespeicherte und effektive Einstellungen zeigt, wobei type auf slack_workspace_effective gesetzt ist. Erfordert den Scope read:claude_tag.

client = anthropic.Anthropic()

effective = client.beta.organization.claude_tag.slack_workspaces.effective.retrieve(
    "slws_011CZkZnWa7xPc3uJfZe5LgT"
)

print(effective.settings.enabled)

Slack-Standardeinstellungen

Deine Organisation hat genau ein Objekt für die Slack-Standardeinstellungen. Es gilt für jeden Workspace und jeden Kanal, hat keine id und keine effektive Ansicht, da keine Ebene umfassender ist.

Die Slack-Standardeinstellungen abrufen

GET /v1/organizations/claude_tag/slack_defaults gibt das Objekt zurück. Eine Organisation, deren Slack-Standardeinstellungen nicht eingerichtet sind, erhält 200, wobei jede Einstellung und agent_id null sind. Erfordert den Scope read:claude_tag.

client = anthropic.Anthropic()

defaults = client.beta.organization.claude_tag.slack_defaults.retrieve()

print(defaults.settings.guest_policy)

Die Slack-Standardeinstellungen aktualisieren

POST /v1/organizations/claude_tag/slack_defaults ändert die Standardeinstellungen und gibt das Objekt zurück. settings ist erforderlich und folgt den Regeln unter Einstellungen ändern. Eine Anfrage, die einen Wert festlegt, während die Slack-Standardeinstellungen nicht eingerichtet sind, gibt 400 zurück. Erfordert den Scope write:claude_tag.

client = anthropic.Anthropic()

defaults = client.beta.organization.claude_tag.slack_defaults.update(
    settings={
        "instructions": "Keep replies under 200 words.",
        "environment_id": "env_011CZkZqDx2zRf5tLjCs7NpV",
    },
)

print(defaults.settings.environment_id)

{
  "type": "slack_defaults",
  "settings": {
    "enabled": null,
    "instructions": "Keep replies under 200 words.",
    "model": null,
    "environment_id": "env_011CZkZqDx2zRf5tLjCs7NpV",
    "guest_policy": null
  },
  "agent_id": "cagt_011CZkZtKa8cUj4wPnFv6RsY"
}

Bundles

Ein Bundle ist das, was claude.ai ein Access Bundle nennt: eine benannte Menge an Zugriffen, etwa Connectors, Repositories und Anmeldedaten, die Claude in einem Kanal oder Workspace verwenden kann. Organisationseigentümer erstellen, bearbeiten und löschen Bundles in claude.ai. Diese API listet sie auf und hängt sie an. Sie gibt den Namen und die Beschreibung eines Bundles zurück, aber nie, was das Bundle gewährt.

Eine bundle_id ohne das Präfix capp_ gibt 400 zurück. Eine, die das Präfix trägt, aber nicht existiert oder zu einer anderen Organisation gehört, gibt 404 zurück, unabhängig davon, was die Anfrage sonst enthält. Bundles, die Claude Tag für sich selbst verwaltet, werden nicht aufgelistet und geben 404 zurück.

Bundles auflisten

GET /v1/organizations/claude_tag/bundles listet die Bundles deiner Organisation auf, die neuesten zuerst nach created_at. Erfordert den Scope read:claude_tag.

client = anthropic.Anthropic()

bundles = client.beta.organization.claude_tag.bundles.list()

# Ruft bei Bedarf automatisch weitere Seiten ab.
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
}

Ein Bundle abrufen

GET /v1/organizations/claude_tag/bundles/{bundle_id} gibt das Bundle-Objekt zurück. Erfordert den Scope read:claude_tag.

client = anthropic.Anthropic()

bundle = client.beta.organization.claude_tag.bundles.retrieve(
    "capp_011CZkZjLP1cWxj5EtMmdgbq"
)

print(bundle.display_name)

Bundle-Ziele

Ein Bundle-Ziel ist der Datensatz eines Bundles, das an einen Kanal oder einen Workspace angehängt ist. Ein an einen Workspace angehängtes Bundle kann im Workspace und in jedem Kanal darin verwendet werden. Ein an einen Kanal angehängtes Bundle kann nur in diesem Kanal verwendet werden.

Ein Bundle wird höchstens einmal an einen Kanal oder Workspace angehängt, und dasselbe Paar hat immer dieselbe id, auch nach einem Trennen und erneuten Anhängen. Die id ist opak: Hole sie aus der Antwort auf ein Anhängen oder aus der Liste. Ein Bundle-Ziel enthält nicht die id seines Bundles, die seine Pfade ebenfalls benötigen, also bewahre beide zusammen auf.

Durch das erste an einen Kanal oder Workspace angehängte Bundle gilt dieser als konfiguriert. Anhängen oder Trennen ändert keine gespeicherte Einstellung. Sitzungen, die im Kanal oder Workspace laufen, werden darüber informiert, dass sich sein Zugriff geändert hat.

Das Bundle, das claude.ai im Rahmen einer On-Call-Einrichtung anhängt, wird aufgelistet und kann gelesen, aber hier nicht angehängt oder getrennt werden, und an einen Kanal oder Workspace, den eine On-Call-Einrichtung verwaltet, kann nichts angehängt oder davon getrennt werden. Jede dieser Anfragen gibt 400 zurück.

Die Ziele eines Bundles auflisten

GET /v1/organizations/claude_tag/bundles/{bundle_id}/targets listet die Kanäle und Workspaces auf, an die das Bundle angehängt ist, die neuesten zuerst nach created_at. Erfordert den Scope read:claude_tag.

client = anthropic.Anthropic()

targets = client.beta.organization.claude_tag.bundles.targets.list(
    "capp_011CZkZjLP1cWxj5EtMmdgbq"
)

# Ruft bei Bedarf automatisch weitere Seiten ab.
for target in targets:
    print(f"{target.id}: {target.type}")

{
  "data": [
    {
      "type": "slack_channel",
      "id": "btgt_011CZkZpBv9yQd6wKhAr8MnU",
      "slack_channel_id": "slch_011CZkZmRt4vNq8sHbYw2KdX",
      "created_at": "2026-10-19T16:21:44Z"
    },
    {
      "type": "slack_workspace",
      "id": "btgt_011CZkZuMc3dVk7xQpGw9StZ",
      "slack_workspace_id": "slws_011CZkZnWa7xPc3uJfZe5LgT",
      "created_at": "2026-09-12T08:17:02Z"
    }
  ],
  "next_page": null
}

Nur Zuordnungen zu Kanälen und Workspaces werden aufgelistet. Ein Bundle, das in claude.ai an etwas anderes angehängt ist, etwa an Default Slack access, hat dafür kein Bundle-Ziel, und ebenso wenig eine Regel, die ein Bundle in vielen Kanälen gleichzeitig anwendet. Die Bundles, die Claude in einem Kanal verwenden kann, können also mehr sein als die Ziele, die ihn benennen. Kein Endpunkt listet die an einen einzelnen Kanal oder Workspace angehängten Bundles auf.

Ein Bundle anhängen

POST /v1/organizations/claude_tag/bundles/{bundle_id}/targets hängt das Bundle an und gibt das Bundle-Ziel zurück. Der Body benennt den type und die passende id. Der Kanal oder Workspace muss bereits eingerichtet sein: Anhängen richtet nie einen Kanal ein. Das Anhängen eines bereits angehängten Paares gibt 200 mit dem vorhandenen Bundle-Ziel zurück. Erfordert den Scope write:claude_tag.

Hänge ein Bundle an einen Kanal an:

client = anthropic.Anthropic()

target = client.beta.organization.claude_tag.bundles.targets.create(
    "capp_011CZkZjLP1cWxj5EtMmdgbq",
    type="slack_channel",
    slack_channel_id="slch_011CZkZmRt4vNq8sHbYw2KdX",
)

print(target.id)

{
  "type": "slack_channel",
  "id": "btgt_011CZkZpBv9yQd6wKhAr8MnU",
  "slack_channel_id": "slch_011CZkZmRt4vNq8sHbYw2KdX",
  "created_at": "2026-10-19T16:21:44Z"
}

Hänge ein Bundle an einen Workspace an:

client = anthropic.Anthropic()

target = client.beta.organization.claude_tag.bundles.targets.create(
    "capp_011CZkZjLP1cWxj5EtMmdgbq",
    type="slack_workspace",
    slack_workspace_id="slws_011CZkZnWa7xPc3uJfZe5LgT",
)

print(target.id)

Eine Zuordnung zu einem Kanal hat Bedingungen, unter denen sie gilt, etwa nur solange sich kein Slack-Gast im Kanal befindet. Bedingungen werden in claude.ai festgelegt und hier nicht zurückgegeben. Das Anhängen über diese API verwendet die Standardbedingungen, und das Anhängen eines bereits angehängten Paares lässt dessen Bedingungen unverändert.

Ein Bundle-Ziel abrufen

GET /v1/organizations/claude_tag/bundles/{bundle_id}/targets/{target_id} gibt das Bundle-Ziel zurück. Eine target_id ohne das Präfix btgt_ gibt 400 zurück. Eine, die zu einem anderen Bundle gehört, getrennt wurde oder einen Kanal oder Workspace bezeichnet, der nicht mehr eingerichtet ist, gibt 404 zurück. Erfordert den Scope read:claude_tag.

client = anthropic.Anthropic()

target = client.beta.organization.claude_tag.bundles.targets.retrieve(
    "btgt_011CZkZpBv9yQd6wKhAr8MnU",
    bundle_id="capp_011CZkZjLP1cWxj5EtMmdgbq",
)

print(target.type)

Ein Bundle trennen

DELETE /v1/organizations/claude_tag/bundles/{bundle_id}/targets/{target_id} trennt das Bundle. Ein wiederholtes Trennen gibt 404 zurück. Erfordert den Scope write:claude_tag.

client = anthropic.Anthropic()

deleted_target = client.beta.organization.claude_tag.bundles.targets.delete(
    "btgt_011CZkZpBv9yQd6wKhAr8MnU",
    bundle_id="capp_011CZkZjLP1cWxj5EtMmdgbq",
)

print(deleted_target.id)

{
  "type": "bundle_target_deleted",
  "id": "btgt_011CZkZpBv9yQd6wKhAr8MnU"
}

Unbekannte Werte

guest_policy.type, der type einer Quelle, der type eines Bundle-Ziels und Fehlercodes können jederzeit neue Werte erhalten. Behandle einen Wert, den du nicht kennst, wie jeden anderen unbekannten String, statt einen Fehler auszulösen.

Ratenlimits

Anfragen werden pro Organisation begrenzt, in zwei Budgets, die sich alle Keys deiner Organisation teilen und die von den übrigen Admin-API-Limits deiner Organisation getrennt sind. Jedes Budget erlaubt einen „burst“ (Lastspitze) und füllt sich dann mit einer gleichmäßigen Rate wieder auf:

Anfragen über einem Budget geben 429 Too Many Requests mit einem retry-after-Header zurück. Antworten enthalten die Header anthropic-ratelimit-requests-limit, anthropic-ratelimit-requests-remaining und anthropic-ratelimit-requests-reset für das Budget, aus dem die Anfrage verbraucht hat.

Paginierung

Listen-Endpunkte verwenden einen opaken Cursor. Die erste Anfrage gibt bis zu limit Zeilen plus einen next_page-Cursor zurück; übergib den Cursor unverändert als Parameter page bei der nächsten Anfrage und wiederhole dies, bis next_page null ist. Behandle den Cursor-String als opak: Parse, verändere oder konstruiere ihn nicht selbst. Kanäle auflisten kann eine Seite mit weniger als limit Kanälen oder gar keinen zurückgeben, während next_page noch gesetzt ist, also fordere weiter Seiten an, bis next_page null ist. Die Listen-Iteratoren der Python-, TypeScript-, C#-, Go-, Java- und Ruby-SDKs sowie die CLI (außer mit --format raw) erledigen das für dich. In PHP und curl forderst du jede Seite selbst an und übergibst ihr next_page als page.

limit ist standardmäßig 20, mit einem Minimum von 1 und einem Maximum von 100. Jede Liste ist nach created_at mit den neuesten zuerst sortiert und akzeptiert keine andere Reihenfolge.

Fehlerantworten

Fehlerantworten folgen der Standardform, die unter Fehler dokumentiert ist. Gib die request_id aus dem Antwort-Body an, wenn du den Support kontaktierst.

Wenn ein Status mehrere Ursachen hat, die du unterschiedlich behandeln würdest, enthält der Fehler zusätzlich 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"
}

Neue Codes können hinzukommen. Behandle einen Code, den du nicht kennst, so wie seinen Status. Ein 404 ohne error_code hat eine von zwei Ursachen. Entweder wurde etwas, das die Anfrage benennt, nicht gefunden (eine id im Pfad oder ein Slack-Kanal oder -Workspace im Body oder in der Query), oder jeder Endpunkt erscheint als nicht existent, weil die Anfrage den anthropic-beta-Wert weglässt oder die API für deine Organisation nicht aktiviert ist. Um sie zu unterscheiden, rufe die Slack-Standardeinstellungen ab mit demselben Key und denselben Headern: Diese Anfrage benennt nichts, daher gibt sie 404 nur im zweiten Fall zurück.

Activity Feed-Ereignisse

Jede Änderung über diese API wird im Compliance API Activity Feed deiner Organisation aufgezeichnet und dem API-Key als api_actor mit dessen apikey_-ID zugeordnet. Die Ereignisse sind dieselben, die der Feed aufzeichnet, wenn dieselbe Änderung in claude.ai vorgenommen wird, sodass eine einzige Abfrage eine Änderung findet, egal auf welchem Weg sie vorgenommen wurde.

Die Ereignisse benennen einen Kanal oder Workspace über seine agent_id, nicht über seine id. Die beiden Bundle-Ereignisse benennen das Bundle in profile_id und den Kanal oder Workspace in scope_id.

Ein ccr_agent_updated-Ereignis listet in updated_fields auf, was sich geändert hat, und zwar unter den eigenen Namen des Feeds:

Lesezugriffe, Anfragen, die nichts ändern, und Anfragen, die abgelehnt werden, bevor etwas gespeichert wird, zeichnen nichts auf. Eine Einrichtungsanfrage, die einen Kanal einrichtet und deren settings anschließend abgelehnt wird, zeichnet ccr_agent_created auf.

Siehe auch