--- title: Claude Tag url: https://platform.claude.com/docs/en/api/beta/organization/claude_tag --- # Claude Tag ## Domain types ### Beta Claude Tag Default Setting Source - `BetaClaudeTagDefaultSettingSource object` No settings level sets a value, and the built-in default applies. - `type: "default"` ### Beta Claude Tag Guest Policy - `BetaClaudeTagGuestPolicy = BetaClaudeTagGuestPolicyAllow or BetaClaudeTagGuestPolicyRestrict or BetaClaudeTagGuestPolicyChannelOnly` What Claude does in a channel while a Slack guest is in it, for everyone in the channel. It changes nothing in a channel without Slack guests. More types can be added. - `BetaClaudeTagGuestPolicyAllow object` Claude answers in the channel. - `type: "allow"` - `BetaClaudeTagGuestPolicyRestrict object` Claude does not answer in the channel. - `type: "restrict"` - `BetaClaudeTagGuestPolicyChannelOnly object` Claude answers with only the Bundles attached to the channel itself. - `type: "channel_only"` ### Beta Claude Tag Guest Policy Allow - `BetaClaudeTagGuestPolicyAllow object` Claude answers in the channel. - `type: "allow"` ### Beta Claude Tag Guest Policy Channel Only - `BetaClaudeTagGuestPolicyChannelOnly object` Claude answers with only the Bundles attached to the channel itself. - `type: "channel_only"` ### Beta Claude Tag Guest Policy Restrict - `BetaClaudeTagGuestPolicyRestrict object` Claude does not answer in the channel. - `type: "restrict"` ### Beta Claude Tag Setting Source - `BetaClaudeTagSettingSource = BetaClaudeTagSlackChannelSettingSource or BetaClaudeTagSlackWorkspaceSettingSource or BetaClaudeTagSlackParentChannelSettingSource or 3 more` The settings level a value comes from. More types can be added. - `BetaClaudeTagSlackChannelSettingSource object` The value comes from the addressed Slack channel itself. - `type: "slack_channel"` - `slack_channel_id: string` The channel's identifier, starting with `slch_`. - `BetaClaudeTagSlackWorkspaceSettingSource object` The value comes from a Slack workspace of the organization. - `type: "slack_workspace"` - `slack_workspace_id: string` The workspace's identifier, starting with `slws_`. - `BetaClaudeTagSlackParentChannelSettingSource object` The value comes from the channel that a code channel was started from. A parent channel contributes `instructions` and `environment_id` only. - `type: "slack_parent_channel"` - `slack_channel_id: string` The parent channel's identifier, starting with `slch_`. - `BetaClaudeTagSlackDefaultSettingSource object` The value comes from the organization's Slack defaults, which have no identifier. - `type: "slack_default"` - `BetaClaudeTagDefaultSettingSource object` No settings level sets a value, and the built-in default applies. - `type: "default"` - `BetaClaudeTagSlackGridChannelSettingSource object` The value comes from the addressed channel as it is set up under another workspace of its Enterprise Grid: a channel shared across the Grid keeps one Slack channel identifier in every workspace that sees it. - `type: "slack_grid_channel"` - `slack: BetaClaudeTagSlackChannelIdentifiers` Slack's own identifiers for the channel under that other workspace. - `channel_id: string` Slack's identifier for the channel, starting with `C` or `G`, such as `C0456EFGH`. minLength: 2, maxLength: 32 - `workspace_id: string` Slack's identifier for the workspace the channel is in, starting with `T`, such as `T0123ABCD`. minLength: 2, maxLength: 32 ### Beta Claude Tag Setting Sources - `BetaClaudeTagSettingSources object` For each setting, the settings level its value in `settings` comes from. Without `include_inherited`, a setting the channel or workspace stores has a source that names the channel or workspace itself, and one it does not store has null, or an empty list for `instructions`. With `include_inherited=true` no member is null: a value that no settings level sets has the source `default`. - `enabled: BetaClaudeTagSettingSource or null` The settings level `enabled` comes from. - `BetaClaudeTagSlackChannelSettingSource object` The value comes from the addressed Slack channel itself. - `type: "slack_channel"` - `slack_channel_id: string` The channel's identifier, starting with `slch_`. - `BetaClaudeTagSlackWorkspaceSettingSource object` The value comes from a Slack workspace of the organization. - `type: "slack_workspace"` - `slack_workspace_id: string` The workspace's identifier, starting with `slws_`. - `BetaClaudeTagSlackParentChannelSettingSource object` The value comes from the channel that a code channel was started from. A parent channel contributes `instructions` and `environment_id` only. - `type: "slack_parent_channel"` - `slack_channel_id: string` The parent channel's identifier, starting with `slch_`. - `BetaClaudeTagSlackDefaultSettingSource object` The value comes from the organization's Slack defaults, which have no identifier. - `type: "slack_default"` - `BetaClaudeTagDefaultSettingSource object` No settings level sets a value, and the built-in default applies. - `type: "default"` - `BetaClaudeTagSlackGridChannelSettingSource object` The value comes from the addressed channel as it is set up under another workspace of its Enterprise Grid: a channel shared across the Grid keeps one Slack channel identifier in every workspace that sees it. - `type: "slack_grid_channel"` - `slack: BetaClaudeTagSlackChannelIdentifiers` Slack's own identifiers for the channel under that other workspace. - `channel_id: string` Slack's identifier for the channel, starting with `C` or `G`, such as `C0456EFGH`. minLength: 2, maxLength: 32 - `workspace_id: string` Slack's identifier for the workspace the channel is in, starting with `T`, such as `T0123ABCD`. minLength: 2, maxLength: 32 - `environment_id: BetaClaudeTagSettingSource or null` The settings level `environment_id` comes from. - `guest_policy: BetaClaudeTagSettingSource or null` The settings level `guest_policy` comes from. - `instructions: array of BetaClaudeTagSettingSource` Every settings level that contributes text to `instructions`, broadest first, in the order their text is joined. Empty when none does. - `BetaClaudeTagSlackChannelSettingSource object` The value comes from the addressed Slack channel itself. - `BetaClaudeTagSlackWorkspaceSettingSource object` The value comes from a Slack workspace of the organization. - `BetaClaudeTagSlackParentChannelSettingSource object` The value comes from the channel that a code channel was started from. A parent channel contributes `instructions` and `environment_id` only. - `BetaClaudeTagSlackDefaultSettingSource object` The value comes from the organization's Slack defaults, which have no identifier. - `BetaClaudeTagDefaultSettingSource object` No settings level sets a value, and the built-in default applies. - `BetaClaudeTagSlackGridChannelSettingSource object` The value comes from the addressed channel as it is set up under another workspace of its Enterprise Grid: a channel shared across the Grid keeps one Slack channel identifier in every workspace that sees it. - `model: BetaClaudeTagSettingSource or null` The settings level `model` comes from. ### Beta Claude Tag Settings - `BetaClaudeTagSettings object` Claude Tag settings. Without `include_inherited`, a setting that is null is not set on the settings level and is inherited. With it, `enabled` and `guest_policy` are never null, and `instructions`, `model` and `environment_id` are null when no settings level sets them. - `enabled: boolean or null` Whether Claude is on. The nearest settings level that sets it decides. - `environment_id: string or null` The environment Claude's sessions run in, starting with `env_`, or the identifier of a self-hosted runner pool, starting with `ccpool_`. The nearest settings level that sets it decides. - `guest_policy: BetaClaudeTagGuestPolicy or null` What Claude does in a channel while a Slack guest is in it. The nearest settings level that sets it decides. - `BetaClaudeTagGuestPolicyAllow object` Claude answers in the channel. - `type: "allow"` - `BetaClaudeTagGuestPolicyRestrict object` Claude does not answer in the channel. - `type: "restrict"` - `BetaClaudeTagGuestPolicyChannelOnly object` Claude answers with only the Bundles attached to the channel itself. - `type: "channel_only"` - `instructions: string or null` Instructions for Claude. Instructions add up: the text of every settings level that sets it is joined, broadest first. - `model: string or null` The model Claude uses: a model identifier or the name of a model line. The nearest settings level that sets it decides. When none does, Claude uses the product's default model. ### Beta Claude Tag Settings Create - `BetaClaudeTagSettingsCreate object` The settings in a request that sets a Slack channel up. A setting left out is not set. A setting sent as null is cleared. - `enabled: optional boolean or null` Whether Claude is on. `true` on a channel turns Claude on in it even when its workspace stores `false`. Null clears it. - `environment_id: optional string or null` The environment Claude's sessions run in: the identifier of an active environment of the organization, starting with `env_`. Null clears it. minLength: 1, maxLength: 64 - `guest_policy: optional BetaClaudeTagGuestPolicy or null` What Claude does in a channel while a Slack guest is in it. Null clears it. - `BetaClaudeTagGuestPolicyAllow object` Claude answers in the channel. - `type: "allow"` - `BetaClaudeTagGuestPolicyRestrict object` Claude does not answer in the channel. - `type: "restrict"` - `BetaClaudeTagGuestPolicyChannelOnly object` Claude answers with only the Bundles attached to the channel itself. - `type: "channel_only"` - `instructions: optional string or null` Instructions for Claude, up to 8,192 characters after leading and trailing white space is trimmed. Null or blank text clears them. - `model: optional string or null` The model Claude uses: the identifier of a model, or the name of a model line, that the organization is entitled to for Claude Tag. Null clears it. minLength: 1, maxLength: 128 ### Beta Claude Tag Settings Update - `BetaClaudeTagSettingsUpdate object` The settings to change. A setting left out is unchanged. A setting sent as null is cleared, so it is inherited. - `enabled: optional boolean or null` Whether Claude is on. `true` on a channel turns Claude on in it even when its workspace stores `false`. Null clears it. - `environment_id: optional string or null` The environment Claude's sessions run in: the identifier of an active environment of the organization, starting with `env_`. Null clears it. minLength: 1, maxLength: 64 - `guest_policy: optional BetaClaudeTagGuestPolicy or null` What Claude does in a channel while a Slack guest is in it. Null clears it. - `BetaClaudeTagGuestPolicyAllow object` Claude answers in the channel. - `type: "allow"` - `BetaClaudeTagGuestPolicyRestrict object` Claude does not answer in the channel. - `type: "restrict"` - `BetaClaudeTagGuestPolicyChannelOnly object` Claude answers with only the Bundles attached to the channel itself. - `type: "channel_only"` - `instructions: optional string or null` Instructions for Claude, up to 8,192 characters after leading and trailing white space is trimmed. Null or blank text clears them. - `model: optional string or null` The model Claude uses: the identifier of a model, or the name of a model line, that the organization is entitled to for Claude Tag. Null clears it. minLength: 1, maxLength: 128 ### Beta Claude Tag Slack Channel Identifiers - `BetaClaudeTagSlackChannelIdentifiers object` The identifiers Slack shows for a channel. They are Slack's own, not identifiers of this API. - `channel_id: string` Slack's identifier for the channel, starting with `C` or `G`, such as `C0456EFGH`. minLength: 2, maxLength: 32 - `workspace_id: string` Slack's identifier for the workspace the channel is in, starting with `T`, such as `T0123ABCD`. minLength: 2, maxLength: 32 ### Beta Claude Tag Slack Channel Setting Source - `BetaClaudeTagSlackChannelSettingSource object` The value comes from the addressed Slack channel itself. - `type: "slack_channel"` - `slack_channel_id: string` The channel's identifier, starting with `slch_`. ### Beta Claude Tag Slack Default Setting Source - `BetaClaudeTagSlackDefaultSettingSource object` The value comes from the organization's Slack defaults, which have no identifier. - `type: "slack_default"` ### Beta Claude Tag Slack Grid Channel Setting Source - `BetaClaudeTagSlackGridChannelSettingSource object` The value comes from the addressed channel as it is set up under another workspace of its Enterprise Grid: a channel shared across the Grid keeps one Slack channel identifier in every workspace that sees it. - `type: "slack_grid_channel"` - `slack: BetaClaudeTagSlackChannelIdentifiers` Slack's own identifiers for the channel under that other workspace. - `channel_id: string` Slack's identifier for the channel, starting with `C` or `G`, such as `C0456EFGH`. minLength: 2, maxLength: 32 - `workspace_id: string` Slack's identifier for the workspace the channel is in, starting with `T`, such as `T0123ABCD`. minLength: 2, maxLength: 32 ### Beta Claude Tag Slack Parent Channel Setting Source - `BetaClaudeTagSlackParentChannelSettingSource object` The value comes from the channel that a code channel was started from. A parent channel contributes `instructions` and `environment_id` only. - `type: "slack_parent_channel"` - `slack_channel_id: string` The parent channel's identifier, starting with `slch_`. ### Beta Claude Tag Slack Workspace Identifiers - `BetaClaudeTagSlackWorkspaceIdentifiers object` The identifier Slack shows for a workspace. It is Slack's own, not an identifier of this API. - `workspace_id: string` Slack's identifier for the workspace, starting with `T`, such as `T0123ABCD`. ### Beta Claude Tag Slack Workspace Setting Source - `BetaClaudeTagSlackWorkspaceSettingSource object` The value comes from a Slack workspace of the organization. - `type: "slack_workspace"` - `slack_workspace_id: string` The workspace's identifier, starting with `slws_`. ## Claude Tag › Slack Channels ### Set Up Slack Channel **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. #### Headers - `"anthropic-version": optional string` The version of the Claude API you want to use. Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning?sdk_languages=http). - `"anthropic-beta": optional array of AnthropicBeta` This endpoint is in beta: requests must send `experimental-claude-tag-2026-10-21` in this header. - `string` - `"message-batches-2024-09-24"` - `"prompt-caching-2024-07-31"` - `"computer-use-2024-10-22"` - `"computer-use-2025-01-24"` - `"pdfs-2024-09-25"` - `"token-counting-2024-11-01"` - `"token-efficient-tools-2025-02-19"` - `"output-128k-2025-02-19"` - `"files-api-2025-04-14"` - `"mcp-client-2025-04-04"` - `"mcp-client-2025-11-20"` - `"dev-full-thinking-2025-05-14"` - `"interleaved-thinking-2025-05-14"` - `"code-execution-2025-05-22"` - `"extended-cache-ttl-2025-04-11"` - `"context-1m-2025-08-07"` - `"context-management-2025-06-27"` - `"model-context-window-exceeded-2025-08-26"` - `"skills-2025-10-02"` - `"fast-mode-2026-02-01"` - `"output-300k-2026-03-24"` - `"user-profiles-2026-03-24"` - `"user-profiles-2026-08-18"` - `"user-profiles-2026-09-04"` - `"advisor-tool-2026-03-01"` - `"managed-agents-2026-04-01"` - `"cache-diagnosis-2026-04-07"` - `"dreaming-2026-04-21"` - `"thinking-token-count-2026-05-13"` - `"server-side-fallback-2026-06-01"` - `"server-side-fallback-2026-07-01"` - `"fallback-credit-2026-06-01"` - `"fallback-credit-2026-07-01"` - `"agent-memory-2026-07-22"` - `"mid-conversation-tool-changes-2026-07-01"` - `"compact-2026-01-12"` - `"computer-use-2025-11-24"` - `"mcp-tunnels-2026-06-22"` - `"structured-outputs-2025-11-13"` - `"task-budgets-2026-03-13"` - `"thinking-display-updates-2026-08-18"` - `"ce-user-management-2026-07-13"` - `"mid-conversation-output-config-2026-07-01"` - `"thinking-binding-controls-2026-08-01"` - `"mid-conversation-system-clear-at-2026-08-21"` - `"compact-2026-09-04"` - `"inline-tools-2026-09-15"` - `"mcp-client-2026-09-15"` - `"ce-plugins-2026-09-01"` - `"spend-limit-reads-2026-09-26"` - `"telemetry-destinations-2026-08-11"` - `"webhooks-2026-10-07"` - `"message-threads-2026-08-12"` - `"analytics-usage-cost-2026-08-24"` - `"experimental-claude-tag-2026-10-21"` #### Body parameters - `slack: BetaClaudeTagSlackChannelIdentifiers` Slack's own identifiers for the channel to set up. The organization must own the workspace. - `channel_id: string` Slack's identifier for the channel, starting with `C` or `G`, such as `C0456EFGH`. minLength: 2, maxLength: 32 - `workspace_id: string` Slack's identifier for the workspace the channel is in, starting with `T`, such as `T0123ABCD`. minLength: 2, maxLength: 32 - `settings: optional BetaClaudeTagSettingsCreate` Settings to store on the channel, applied as Update Slack Channel applies them. - `enabled: optional boolean or null` Whether Claude is on. `true` on a channel turns Claude on in it even when its workspace stores `false`. Null clears it. - `environment_id: optional string or null` The environment Claude's sessions run in: the identifier of an active environment of the organization, starting with `env_`. Null clears it. minLength: 1, maxLength: 64 - `guest_policy: optional BetaClaudeTagGuestPolicy or null` What Claude does in a channel while a Slack guest is in it. Null clears it. - `BetaClaudeTagGuestPolicyAllow object` Claude answers in the channel. - `type: "allow"` - `BetaClaudeTagGuestPolicyRestrict object` Claude does not answer in the channel. - `type: "restrict"` - `BetaClaudeTagGuestPolicyChannelOnly object` Claude answers with only the Bundles attached to the channel itself. - `type: "channel_only"` - `instructions: optional string or null` Instructions for Claude, up to 8,192 characters after leading and trailing white space is trimmed. Null or blank text clears them. - `model: optional string or null` The model Claude uses: the identifier of a model, or the name of a model line, that the organization is entitled to for Claude Tag. Null clears it. minLength: 1, maxLength: 128 #### Returns - `BetaClaudeTagSlackChannel object` A Slack channel set up for Claude Tag, with the settings it stores or, with `include_inherited`, the settings that apply in it. - `type: "slack_channel"` - `id: string` The channel's identifier. Starts with `slch_`. It does not change for as long as the channel is set up, with one exception: a channel that is not configured gets a new one when claude.ai replaces its record, which happens only while the organization's read-only mode is off. A channel that is removed and set up again also has a new one. The old one keeps returning 404; look the channel up by its Slack identifiers for the new one. - `created_at: string` Time the channel was set up, by whichever route. It does not change for as long as `id` does not. format: date-time - `settings: BetaClaudeTagSettings` What the channel itself stores or, with `include_inherited`, what applies in it. `sources` says which. - `enabled: boolean or null` Whether Claude is on. The nearest settings level that sets it decides. - `environment_id: string or null` The environment Claude's sessions run in, starting with `env_`, or the identifier of a self-hosted runner pool, starting with `ccpool_`. The nearest settings level that sets it decides. - `guest_policy: BetaClaudeTagGuestPolicy or null` What Claude does in a channel while a Slack guest is in it. The nearest settings level that sets it decides. - `BetaClaudeTagGuestPolicyAllow object` Claude answers in the channel. - `type: "allow"` - `BetaClaudeTagGuestPolicyRestrict object` Claude does not answer in the channel. - `type: "restrict"` - `BetaClaudeTagGuestPolicyChannelOnly object` Claude answers with only the Bundles attached to the channel itself. - `type: "channel_only"` - `instructions: string or null` Instructions for Claude. Instructions add up: the text of every settings level that sets it is joined, broadest first. - `model: string or null` The model Claude uses: a model identifier or the name of a model line. The nearest settings level that sets it decides. When none does, Claude uses the product's default model. - `slack: BetaClaudeTagSlackChannelIdentifiers` Slack's own identifiers for the channel. - `channel_id: string` Slack's identifier for the channel, starting with `C` or `G`, such as `C0456EFGH`. minLength: 2, maxLength: 32 - `workspace_id: string` Slack's identifier for the workspace the channel is in, starting with `T`, such as `T0123ABCD`. minLength: 2, maxLength: 32 - `sources: BetaClaudeTagSettingSources` For each setting, the settings level its value in `settings` comes from. - `enabled: BetaClaudeTagSettingSource or null` The settings level `enabled` comes from. - `BetaClaudeTagSlackChannelSettingSource object` The value comes from the addressed Slack channel itself. - `type: "slack_channel"` - `slack_channel_id: string` The channel's identifier, starting with `slch_`. - `BetaClaudeTagSlackWorkspaceSettingSource object` The value comes from a Slack workspace of the organization. - `type: "slack_workspace"` - `slack_workspace_id: string` The workspace's identifier, starting with `slws_`. - `BetaClaudeTagSlackParentChannelSettingSource object` The value comes from the channel that a code channel was started from. A parent channel contributes `instructions` and `environment_id` only. - `type: "slack_parent_channel"` - `slack_channel_id: string` The parent channel's identifier, starting with `slch_`. - `BetaClaudeTagSlackDefaultSettingSource object` The value comes from the organization's Slack defaults, which have no identifier. - `type: "slack_default"` - `BetaClaudeTagDefaultSettingSource object` No settings level sets a value, and the built-in default applies. - `type: "default"` - `BetaClaudeTagSlackGridChannelSettingSource object` The value comes from the addressed channel as it is set up under another workspace of its Enterprise Grid: a channel shared across the Grid keeps one Slack channel identifier in every workspace that sees it. - `type: "slack_grid_channel"` - `slack: BetaClaudeTagSlackChannelIdentifiers` Slack's own identifiers for the channel under that other workspace. - `environment_id: BetaClaudeTagSettingSource or null` The settings level `environment_id` comes from. - `guest_policy: BetaClaudeTagSettingSource or null` The settings level `guest_policy` comes from. - `instructions: array of BetaClaudeTagSettingSource` Every settings level that contributes text to `instructions`, broadest first, in the order their text is joined. Empty when none does. - `BetaClaudeTagSlackChannelSettingSource object` The value comes from the addressed Slack channel itself. - `BetaClaudeTagSlackWorkspaceSettingSource object` The value comes from a Slack workspace of the organization. - `BetaClaudeTagSlackParentChannelSettingSource object` The value comes from the channel that a code channel was started from. A parent channel contributes `instructions` and `environment_id` only. - `BetaClaudeTagSlackDefaultSettingSource object` The value comes from the organization's Slack defaults, which have no identifier. - `BetaClaudeTagDefaultSettingSource object` No settings level sets a value, and the built-in default applies. - `BetaClaudeTagSlackGridChannelSettingSource object` The value comes from the addressed channel as it is set up under another workspace of its Enterprise Grid: a channel shared across the Grid keeps one Slack channel identifier in every workspace that sees it. - `model: BetaClaudeTagSettingSource or null` The settings level `model` comes from. - `updated_at: string` Time Claude Tag's record of the channel last changed. It moves on every change to a setting, and can also move when something no response holds changes, so a later value says to read the channel again, not that a setting changed. Attaching or detaching a Bundle does not by itself move it. format: date-time #### Example ```bash curl https://api.anthropic.com/v1/organizations/claude_tag/slack_channels \ -H 'Content-Type: application/json' \ -H 'anthropic-version: 2026-10-21' \ -H 'anthropic-beta: experimental-claude-tag-2026-10-21' \ -H "Authorization: Bearer $ANTHROPIC_API_KEY" \ -d '{ "slack": { "channel_id": "xx", "workspace_id": "xx" } }' ``` ##### Response (200) ```json { "id": "id", "created_at": "2019-12-27T18:11:19.117Z", "settings": { "enabled": true, "environment_id": "environment_id", "guest_policy": { "type": "allow" }, "instructions": "instructions", "model": "model" }, "slack": { "channel_id": "xx", "workspace_id": "xx" }, "sources": { "enabled": { "slack_channel_id": "slack_channel_id", "type": "slack_channel" }, "environment_id": { "slack_channel_id": "slack_channel_id", "type": "slack_channel" }, "guest_policy": { "slack_channel_id": "slack_channel_id", "type": "slack_channel" }, "instructions": [ { "slack_channel_id": "slack_channel_id", "type": "slack_channel" } ], "model": { "slack_channel_id": "slack_channel_id", "type": "slack_channel" } }, "type": "slack_channel", "updated_at": "2019-12-27T18:11:19.117Z" } ``` ### List Slack Channels **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. A workspace that the organization owns only through a Slack Enterprise Grid returns 404 until it is set up. 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`. #### Query parameters - `slack_workspace_id: string` The Slack workspace whose channels to list: Slack's identifier for it, as in the channel object's `slack.workspace_id`, not the workspace object's `id`. - `include_inherited: optional boolean` When `true`, `settings` holds what applies in each channel once the settings levels above it are taken into account, and every member of `sources` names the level a value comes from. When `false` or left out, `settings` holds what each channel itself stores. - `limit: optional number` Number of items to return per page, between 1 and 100. Defaults to 20. format: int32 - `page: optional string` Opaque cursor from a previous response's `next_page`. - `slack_channel_id: optional string` Slack's identifier for one channel of that workspace, as in the channel object's `slack.channel_id`. It is not the channel object's `id`. With it `data` holds that channel alone, or nothing when the channel is not set up. #### Headers - `"anthropic-version": optional string` The version of the Claude API you want to use. Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning?sdk_languages=http). - `"anthropic-beta": optional array of AnthropicBeta` This endpoint is in beta: requests must send `experimental-claude-tag-2026-10-21` in this header. - `string` - `"message-batches-2024-09-24"` - `"prompt-caching-2024-07-31"` - `"computer-use-2024-10-22"` - `"computer-use-2025-01-24"` - `"pdfs-2024-09-25"` - `"token-counting-2024-11-01"` - `"token-efficient-tools-2025-02-19"` - `"output-128k-2025-02-19"` - `"files-api-2025-04-14"` - `"mcp-client-2025-04-04"` - `"mcp-client-2025-11-20"` - `"dev-full-thinking-2025-05-14"` - `"interleaved-thinking-2025-05-14"` - `"code-execution-2025-05-22"` - `"extended-cache-ttl-2025-04-11"` - `"context-1m-2025-08-07"` - `"context-management-2025-06-27"` - `"model-context-window-exceeded-2025-08-26"` - `"skills-2025-10-02"` - `"fast-mode-2026-02-01"` - `"output-300k-2026-03-24"` - `"user-profiles-2026-03-24"` - `"user-profiles-2026-08-18"` - `"user-profiles-2026-09-04"` - `"advisor-tool-2026-03-01"` - `"managed-agents-2026-04-01"` - `"cache-diagnosis-2026-04-07"` - `"dreaming-2026-04-21"` - `"thinking-token-count-2026-05-13"` - `"server-side-fallback-2026-06-01"` - `"server-side-fallback-2026-07-01"` - `"fallback-credit-2026-06-01"` - `"fallback-credit-2026-07-01"` - `"agent-memory-2026-07-22"` - `"mid-conversation-tool-changes-2026-07-01"` - `"compact-2026-01-12"` - `"computer-use-2025-11-24"` - `"mcp-tunnels-2026-06-22"` - `"structured-outputs-2025-11-13"` - `"task-budgets-2026-03-13"` - `"thinking-display-updates-2026-08-18"` - `"ce-user-management-2026-07-13"` - `"mid-conversation-output-config-2026-07-01"` - `"thinking-binding-controls-2026-08-01"` - `"mid-conversation-system-clear-at-2026-08-21"` - `"compact-2026-09-04"` - `"inline-tools-2026-09-15"` - `"mcp-client-2026-09-15"` - `"ce-plugins-2026-09-01"` - `"spend-limit-reads-2026-09-26"` - `"telemetry-destinations-2026-08-11"` - `"webhooks-2026-10-07"` - `"message-threads-2026-08-12"` - `"analytics-usage-cost-2026-08-24"` - `"experimental-claude-tag-2026-10-21"` #### Returns - `data: array of BetaClaudeTagSlackChannel` Channels on this page, newest first. - `type: "slack_channel"` - `id: string` The channel's identifier. Starts with `slch_`. It does not change for as long as the channel is set up, with one exception: a channel that is not configured gets a new one when claude.ai replaces its record, which happens only while the organization's read-only mode is off. A channel that is removed and set up again also has a new one. The old one keeps returning 404; look the channel up by its Slack identifiers for the new one. - `created_at: string` Time the channel was set up, by whichever route. It does not change for as long as `id` does not. format: date-time - `settings: BetaClaudeTagSettings` What the channel itself stores or, with `include_inherited`, what applies in it. `sources` says which. - `enabled: boolean or null` Whether Claude is on. The nearest settings level that sets it decides. - `environment_id: string or null` The environment Claude's sessions run in, starting with `env_`, or the identifier of a self-hosted runner pool, starting with `ccpool_`. The nearest settings level that sets it decides. - `guest_policy: BetaClaudeTagGuestPolicy or null` What Claude does in a channel while a Slack guest is in it. The nearest settings level that sets it decides. - `BetaClaudeTagGuestPolicyAllow object` Claude answers in the channel. - `type: "allow"` - `BetaClaudeTagGuestPolicyRestrict object` Claude does not answer in the channel. - `type: "restrict"` - `BetaClaudeTagGuestPolicyChannelOnly object` Claude answers with only the Bundles attached to the channel itself. - `type: "channel_only"` - `instructions: string or null` Instructions for Claude. Instructions add up: the text of every settings level that sets it is joined, broadest first. - `model: string or null` The model Claude uses: a model identifier or the name of a model line. The nearest settings level that sets it decides. When none does, Claude uses the product's default model. - `slack: BetaClaudeTagSlackChannelIdentifiers` Slack's own identifiers for the channel. - `channel_id: string` Slack's identifier for the channel, starting with `C` or `G`, such as `C0456EFGH`. minLength: 2, maxLength: 32 - `workspace_id: string` Slack's identifier for the workspace the channel is in, starting with `T`, such as `T0123ABCD`. minLength: 2, maxLength: 32 - `sources: BetaClaudeTagSettingSources` For each setting, the settings level its value in `settings` comes from. - `enabled: BetaClaudeTagSettingSource or null` The settings level `enabled` comes from. - `BetaClaudeTagSlackChannelSettingSource object` The value comes from the addressed Slack channel itself. - `type: "slack_channel"` - `slack_channel_id: string` The channel's identifier, starting with `slch_`. - `BetaClaudeTagSlackWorkspaceSettingSource object` The value comes from a Slack workspace of the organization. - `type: "slack_workspace"` - `slack_workspace_id: string` The workspace's identifier, starting with `slws_`. - `BetaClaudeTagSlackParentChannelSettingSource object` The value comes from the channel that a code channel was started from. A parent channel contributes `instructions` and `environment_id` only. - `type: "slack_parent_channel"` - `slack_channel_id: string` The parent channel's identifier, starting with `slch_`. - `BetaClaudeTagSlackDefaultSettingSource object` The value comes from the organization's Slack defaults, which have no identifier. - `type: "slack_default"` - `BetaClaudeTagDefaultSettingSource object` No settings level sets a value, and the built-in default applies. - `type: "default"` - `BetaClaudeTagSlackGridChannelSettingSource object` The value comes from the addressed channel as it is set up under another workspace of its Enterprise Grid: a channel shared across the Grid keeps one Slack channel identifier in every workspace that sees it. - `type: "slack_grid_channel"` - `slack: BetaClaudeTagSlackChannelIdentifiers` Slack's own identifiers for the channel under that other workspace. - `environment_id: BetaClaudeTagSettingSource or null` The settings level `environment_id` comes from. - `guest_policy: BetaClaudeTagSettingSource or null` The settings level `guest_policy` comes from. - `instructions: array of BetaClaudeTagSettingSource` Every settings level that contributes text to `instructions`, broadest first, in the order their text is joined. Empty when none does. - `BetaClaudeTagSlackChannelSettingSource object` The value comes from the addressed Slack channel itself. - `BetaClaudeTagSlackWorkspaceSettingSource object` The value comes from a Slack workspace of the organization. - `BetaClaudeTagSlackParentChannelSettingSource object` The value comes from the channel that a code channel was started from. A parent channel contributes `instructions` and `environment_id` only. - `BetaClaudeTagSlackDefaultSettingSource object` The value comes from the organization's Slack defaults, which have no identifier. - `BetaClaudeTagDefaultSettingSource object` No settings level sets a value, and the built-in default applies. - `BetaClaudeTagSlackGridChannelSettingSource object` The value comes from the addressed channel as it is set up under another workspace of its Enterprise Grid: a channel shared across the Grid keeps one Slack channel identifier in every workspace that sees it. - `model: BetaClaudeTagSettingSource or null` The settings level `model` comes from. - `updated_at: string` Time Claude Tag's record of the channel last changed. It moves on every change to a setting, and can also move when something no response holds changes, so a later value says to read the channel again, not that a setting changed. Attaching or detaching a Bundle does not by itself move it. format: date-time - `next_page: string or null` Cursor for the next page. Null on the last page. #### Example ```bash curl https://api.anthropic.com/v1/organizations/claude_tag/slack_channels \ -H 'anthropic-version: 2026-10-21' \ -H 'anthropic-beta: experimental-claude-tag-2026-10-21' \ -H "Authorization: Bearer $ANTHROPIC_API_KEY" ``` ##### Response (200) ```json { "data": [ { "id": "id", "created_at": "2019-12-27T18:11:19.117Z", "settings": { "enabled": true, "environment_id": "environment_id", "guest_policy": { "type": "allow" }, "instructions": "instructions", "model": "model" }, "slack": { "channel_id": "xx", "workspace_id": "xx" }, "sources": { "enabled": { "slack_channel_id": "slack_channel_id", "type": "slack_channel" }, "environment_id": { "slack_channel_id": "slack_channel_id", "type": "slack_channel" }, "guest_policy": { "slack_channel_id": "slack_channel_id", "type": "slack_channel" }, "instructions": [ { "slack_channel_id": "slack_channel_id", "type": "slack_channel" } ], "model": { "slack_channel_id": "slack_channel_id", "type": "slack_channel" } }, "type": "slack_channel", "updated_at": "2019-12-27T18:11:19.117Z" } ], "next_page": "next_page" } ``` ### Get Slack Channel **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. #### Path parameters - `id: string` The channel's identifier, starting with `slch_`. #### Query parameters - `include_inherited: optional boolean` When `true`, `settings` holds what applies in the channel once the settings levels above it are taken into account, and every member of `sources` names the level a value comes from. When `false` or left out, `settings` holds what the channel itself stores. #### Headers - `"anthropic-version": optional string` The version of the Claude API you want to use. Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning?sdk_languages=http). - `"anthropic-beta": optional array of AnthropicBeta` This endpoint is in beta: requests must send `experimental-claude-tag-2026-10-21` in this header. - `string` - `"message-batches-2024-09-24"` - `"prompt-caching-2024-07-31"` - `"computer-use-2024-10-22"` - `"computer-use-2025-01-24"` - `"pdfs-2024-09-25"` - `"token-counting-2024-11-01"` - `"token-efficient-tools-2025-02-19"` - `"output-128k-2025-02-19"` - `"files-api-2025-04-14"` - `"mcp-client-2025-04-04"` - `"mcp-client-2025-11-20"` - `"dev-full-thinking-2025-05-14"` - `"interleaved-thinking-2025-05-14"` - `"code-execution-2025-05-22"` - `"extended-cache-ttl-2025-04-11"` - `"context-1m-2025-08-07"` - `"context-management-2025-06-27"` - `"model-context-window-exceeded-2025-08-26"` - `"skills-2025-10-02"` - `"fast-mode-2026-02-01"` - `"output-300k-2026-03-24"` - `"user-profiles-2026-03-24"` - `"user-profiles-2026-08-18"` - `"user-profiles-2026-09-04"` - `"advisor-tool-2026-03-01"` - `"managed-agents-2026-04-01"` - `"cache-diagnosis-2026-04-07"` - `"dreaming-2026-04-21"` - `"thinking-token-count-2026-05-13"` - `"server-side-fallback-2026-06-01"` - `"server-side-fallback-2026-07-01"` - `"fallback-credit-2026-06-01"` - `"fallback-credit-2026-07-01"` - `"agent-memory-2026-07-22"` - `"mid-conversation-tool-changes-2026-07-01"` - `"compact-2026-01-12"` - `"computer-use-2025-11-24"` - `"mcp-tunnels-2026-06-22"` - `"structured-outputs-2025-11-13"` - `"task-budgets-2026-03-13"` - `"thinking-display-updates-2026-08-18"` - `"ce-user-management-2026-07-13"` - `"mid-conversation-output-config-2026-07-01"` - `"thinking-binding-controls-2026-08-01"` - `"mid-conversation-system-clear-at-2026-08-21"` - `"compact-2026-09-04"` - `"inline-tools-2026-09-15"` - `"mcp-client-2026-09-15"` - `"ce-plugins-2026-09-01"` - `"spend-limit-reads-2026-09-26"` - `"telemetry-destinations-2026-08-11"` - `"webhooks-2026-10-07"` - `"message-threads-2026-08-12"` - `"analytics-usage-cost-2026-08-24"` - `"experimental-claude-tag-2026-10-21"` #### Returns - `BetaClaudeTagSlackChannel object` A Slack channel set up for Claude Tag, with the settings it stores or, with `include_inherited`, the settings that apply in it. - `type: "slack_channel"` - `id: string` The channel's identifier. Starts with `slch_`. It does not change for as long as the channel is set up, with one exception: a channel that is not configured gets a new one when claude.ai replaces its record, which happens only while the organization's read-only mode is off. A channel that is removed and set up again also has a new one. The old one keeps returning 404; look the channel up by its Slack identifiers for the new one. - `created_at: string` Time the channel was set up, by whichever route. It does not change for as long as `id` does not. format: date-time - `settings: BetaClaudeTagSettings` What the channel itself stores or, with `include_inherited`, what applies in it. `sources` says which. - `enabled: boolean or null` Whether Claude is on. The nearest settings level that sets it decides. - `environment_id: string or null` The environment Claude's sessions run in, starting with `env_`, or the identifier of a self-hosted runner pool, starting with `ccpool_`. The nearest settings level that sets it decides. - `guest_policy: BetaClaudeTagGuestPolicy or null` What Claude does in a channel while a Slack guest is in it. The nearest settings level that sets it decides. - `BetaClaudeTagGuestPolicyAllow object` Claude answers in the channel. - `type: "allow"` - `BetaClaudeTagGuestPolicyRestrict object` Claude does not answer in the channel. - `type: "restrict"` - `BetaClaudeTagGuestPolicyChannelOnly object` Claude answers with only the Bundles attached to the channel itself. - `type: "channel_only"` - `instructions: string or null` Instructions for Claude. Instructions add up: the text of every settings level that sets it is joined, broadest first. - `model: string or null` The model Claude uses: a model identifier or the name of a model line. The nearest settings level that sets it decides. When none does, Claude uses the product's default model. - `slack: BetaClaudeTagSlackChannelIdentifiers` Slack's own identifiers for the channel. - `channel_id: string` Slack's identifier for the channel, starting with `C` or `G`, such as `C0456EFGH`. minLength: 2, maxLength: 32 - `workspace_id: string` Slack's identifier for the workspace the channel is in, starting with `T`, such as `T0123ABCD`. minLength: 2, maxLength: 32 - `sources: BetaClaudeTagSettingSources` For each setting, the settings level its value in `settings` comes from. - `enabled: BetaClaudeTagSettingSource or null` The settings level `enabled` comes from. - `BetaClaudeTagSlackChannelSettingSource object` The value comes from the addressed Slack channel itself. - `type: "slack_channel"` - `slack_channel_id: string` The channel's identifier, starting with `slch_`. - `BetaClaudeTagSlackWorkspaceSettingSource object` The value comes from a Slack workspace of the organization. - `type: "slack_workspace"` - `slack_workspace_id: string` The workspace's identifier, starting with `slws_`. - `BetaClaudeTagSlackParentChannelSettingSource object` The value comes from the channel that a code channel was started from. A parent channel contributes `instructions` and `environment_id` only. - `type: "slack_parent_channel"` - `slack_channel_id: string` The parent channel's identifier, starting with `slch_`. - `BetaClaudeTagSlackDefaultSettingSource object` The value comes from the organization's Slack defaults, which have no identifier. - `type: "slack_default"` - `BetaClaudeTagDefaultSettingSource object` No settings level sets a value, and the built-in default applies. - `type: "default"` - `BetaClaudeTagSlackGridChannelSettingSource object` The value comes from the addressed channel as it is set up under another workspace of its Enterprise Grid: a channel shared across the Grid keeps one Slack channel identifier in every workspace that sees it. - `type: "slack_grid_channel"` - `slack: BetaClaudeTagSlackChannelIdentifiers` Slack's own identifiers for the channel under that other workspace. - `environment_id: BetaClaudeTagSettingSource or null` The settings level `environment_id` comes from. - `guest_policy: BetaClaudeTagSettingSource or null` The settings level `guest_policy` comes from. - `instructions: array of BetaClaudeTagSettingSource` Every settings level that contributes text to `instructions`, broadest first, in the order their text is joined. Empty when none does. - `BetaClaudeTagSlackChannelSettingSource object` The value comes from the addressed Slack channel itself. - `BetaClaudeTagSlackWorkspaceSettingSource object` The value comes from a Slack workspace of the organization. - `BetaClaudeTagSlackParentChannelSettingSource object` The value comes from the channel that a code channel was started from. A parent channel contributes `instructions` and `environment_id` only. - `BetaClaudeTagSlackDefaultSettingSource object` The value comes from the organization's Slack defaults, which have no identifier. - `BetaClaudeTagDefaultSettingSource object` No settings level sets a value, and the built-in default applies. - `BetaClaudeTagSlackGridChannelSettingSource object` The value comes from the addressed channel as it is set up under another workspace of its Enterprise Grid: a channel shared across the Grid keeps one Slack channel identifier in every workspace that sees it. - `model: BetaClaudeTagSettingSource or null` The settings level `model` comes from. - `updated_at: string` Time Claude Tag's record of the channel last changed. It moves on every change to a setting, and can also move when something no response holds changes, so a later value says to read the channel again, not that a setting changed. Attaching or detaching a Bundle does not by itself move it. format: date-time #### Example ```bash curl https://api.anthropic.com/v1/organizations/claude_tag/slack_channels/$ID \ -H 'anthropic-version: 2026-10-21' \ -H 'anthropic-beta: experimental-claude-tag-2026-10-21' \ -H "Authorization: Bearer $ANTHROPIC_API_KEY" ``` ##### Response (200) ```json { "id": "id", "created_at": "2019-12-27T18:11:19.117Z", "settings": { "enabled": true, "environment_id": "environment_id", "guest_policy": { "type": "allow" }, "instructions": "instructions", "model": "model" }, "slack": { "channel_id": "xx", "workspace_id": "xx" }, "sources": { "enabled": { "slack_channel_id": "slack_channel_id", "type": "slack_channel" }, "environment_id": { "slack_channel_id": "slack_channel_id", "type": "slack_channel" }, "guest_policy": { "slack_channel_id": "slack_channel_id", "type": "slack_channel" }, "instructions": [ { "slack_channel_id": "slack_channel_id", "type": "slack_channel" } ], "model": { "slack_channel_id": "slack_channel_id", "type": "slack_channel" } }, "type": "slack_channel", "updated_at": "2019-12-27T18:11:19.117Z" } ``` ### Update Slack Channel **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. #### Path parameters - `id: string` The channel's identifier, starting with `slch_`. #### Headers - `"anthropic-version": optional string` The version of the Claude API you want to use. Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning?sdk_languages=http). - `"anthropic-beta": optional array of AnthropicBeta` This endpoint is in beta: requests must send `experimental-claude-tag-2026-10-21` in this header. - `string` - `"message-batches-2024-09-24"` - `"prompt-caching-2024-07-31"` - `"computer-use-2024-10-22"` - `"computer-use-2025-01-24"` - `"pdfs-2024-09-25"` - `"token-counting-2024-11-01"` - `"token-efficient-tools-2025-02-19"` - `"output-128k-2025-02-19"` - `"files-api-2025-04-14"` - `"mcp-client-2025-04-04"` - `"mcp-client-2025-11-20"` - `"dev-full-thinking-2025-05-14"` - `"interleaved-thinking-2025-05-14"` - `"code-execution-2025-05-22"` - `"extended-cache-ttl-2025-04-11"` - `"context-1m-2025-08-07"` - `"context-management-2025-06-27"` - `"model-context-window-exceeded-2025-08-26"` - `"skills-2025-10-02"` - `"fast-mode-2026-02-01"` - `"output-300k-2026-03-24"` - `"user-profiles-2026-03-24"` - `"user-profiles-2026-08-18"` - `"user-profiles-2026-09-04"` - `"advisor-tool-2026-03-01"` - `"managed-agents-2026-04-01"` - `"cache-diagnosis-2026-04-07"` - `"dreaming-2026-04-21"` - `"thinking-token-count-2026-05-13"` - `"server-side-fallback-2026-06-01"` - `"server-side-fallback-2026-07-01"` - `"fallback-credit-2026-06-01"` - `"fallback-credit-2026-07-01"` - `"agent-memory-2026-07-22"` - `"mid-conversation-tool-changes-2026-07-01"` - `"compact-2026-01-12"` - `"computer-use-2025-11-24"` - `"mcp-tunnels-2026-06-22"` - `"structured-outputs-2025-11-13"` - `"task-budgets-2026-03-13"` - `"thinking-display-updates-2026-08-18"` - `"ce-user-management-2026-07-13"` - `"mid-conversation-output-config-2026-07-01"` - `"thinking-binding-controls-2026-08-01"` - `"mid-conversation-system-clear-at-2026-08-21"` - `"compact-2026-09-04"` - `"inline-tools-2026-09-15"` - `"mcp-client-2026-09-15"` - `"ce-plugins-2026-09-01"` - `"spend-limit-reads-2026-09-26"` - `"telemetry-destinations-2026-08-11"` - `"webhooks-2026-10-07"` - `"message-threads-2026-08-12"` - `"analytics-usage-cost-2026-08-24"` - `"experimental-claude-tag-2026-10-21"` #### Body parameters - `settings: BetaClaudeTagSettingsUpdate` The settings to change. - `enabled: optional boolean or null` Whether Claude is on. `true` on a channel turns Claude on in it even when its workspace stores `false`. Null clears it. - `environment_id: optional string or null` The environment Claude's sessions run in: the identifier of an active environment of the organization, starting with `env_`. Null clears it. minLength: 1, maxLength: 64 - `guest_policy: optional BetaClaudeTagGuestPolicy or null` What Claude does in a channel while a Slack guest is in it. Null clears it. - `BetaClaudeTagGuestPolicyAllow object` Claude answers in the channel. - `type: "allow"` - `BetaClaudeTagGuestPolicyRestrict object` Claude does not answer in the channel. - `type: "restrict"` - `BetaClaudeTagGuestPolicyChannelOnly object` Claude answers with only the Bundles attached to the channel itself. - `type: "channel_only"` - `instructions: optional string or null` Instructions for Claude, up to 8,192 characters after leading and trailing white space is trimmed. Null or blank text clears them. - `model: optional string or null` The model Claude uses: the identifier of a model, or the name of a model line, that the organization is entitled to for Claude Tag. Null clears it. minLength: 1, maxLength: 128 #### Returns - `BetaClaudeTagSlackChannel object` A Slack channel set up for Claude Tag, with the settings it stores or, with `include_inherited`, the settings that apply in it. - `type: "slack_channel"` - `id: string` The channel's identifier. Starts with `slch_`. It does not change for as long as the channel is set up, with one exception: a channel that is not configured gets a new one when claude.ai replaces its record, which happens only while the organization's read-only mode is off. A channel that is removed and set up again also has a new one. The old one keeps returning 404; look the channel up by its Slack identifiers for the new one. - `created_at: string` Time the channel was set up, by whichever route. It does not change for as long as `id` does not. format: date-time - `settings: BetaClaudeTagSettings` What the channel itself stores or, with `include_inherited`, what applies in it. `sources` says which. - `enabled: boolean or null` Whether Claude is on. The nearest settings level that sets it decides. - `environment_id: string or null` The environment Claude's sessions run in, starting with `env_`, or the identifier of a self-hosted runner pool, starting with `ccpool_`. The nearest settings level that sets it decides. - `guest_policy: BetaClaudeTagGuestPolicy or null` What Claude does in a channel while a Slack guest is in it. The nearest settings level that sets it decides. - `BetaClaudeTagGuestPolicyAllow object` Claude answers in the channel. - `type: "allow"` - `BetaClaudeTagGuestPolicyRestrict object` Claude does not answer in the channel. - `type: "restrict"` - `BetaClaudeTagGuestPolicyChannelOnly object` Claude answers with only the Bundles attached to the channel itself. - `type: "channel_only"` - `instructions: string or null` Instructions for Claude. Instructions add up: the text of every settings level that sets it is joined, broadest first. - `model: string or null` The model Claude uses: a model identifier or the name of a model line. The nearest settings level that sets it decides. When none does, Claude uses the product's default model. - `slack: BetaClaudeTagSlackChannelIdentifiers` Slack's own identifiers for the channel. - `channel_id: string` Slack's identifier for the channel, starting with `C` or `G`, such as `C0456EFGH`. minLength: 2, maxLength: 32 - `workspace_id: string` Slack's identifier for the workspace the channel is in, starting with `T`, such as `T0123ABCD`. minLength: 2, maxLength: 32 - `sources: BetaClaudeTagSettingSources` For each setting, the settings level its value in `settings` comes from. - `enabled: BetaClaudeTagSettingSource or null` The settings level `enabled` comes from. - `BetaClaudeTagSlackChannelSettingSource object` The value comes from the addressed Slack channel itself. - `type: "slack_channel"` - `slack_channel_id: string` The channel's identifier, starting with `slch_`. - `BetaClaudeTagSlackWorkspaceSettingSource object` The value comes from a Slack workspace of the organization. - `type: "slack_workspace"` - `slack_workspace_id: string` The workspace's identifier, starting with `slws_`. - `BetaClaudeTagSlackParentChannelSettingSource object` The value comes from the channel that a code channel was started from. A parent channel contributes `instructions` and `environment_id` only. - `type: "slack_parent_channel"` - `slack_channel_id: string` The parent channel's identifier, starting with `slch_`. - `BetaClaudeTagSlackDefaultSettingSource object` The value comes from the organization's Slack defaults, which have no identifier. - `type: "slack_default"` - `BetaClaudeTagDefaultSettingSource object` No settings level sets a value, and the built-in default applies. - `type: "default"` - `BetaClaudeTagSlackGridChannelSettingSource object` The value comes from the addressed channel as it is set up under another workspace of its Enterprise Grid: a channel shared across the Grid keeps one Slack channel identifier in every workspace that sees it. - `type: "slack_grid_channel"` - `slack: BetaClaudeTagSlackChannelIdentifiers` Slack's own identifiers for the channel under that other workspace. - `environment_id: BetaClaudeTagSettingSource or null` The settings level `environment_id` comes from. - `guest_policy: BetaClaudeTagSettingSource or null` The settings level `guest_policy` comes from. - `instructions: array of BetaClaudeTagSettingSource` Every settings level that contributes text to `instructions`, broadest first, in the order their text is joined. Empty when none does. - `BetaClaudeTagSlackChannelSettingSource object` The value comes from the addressed Slack channel itself. - `BetaClaudeTagSlackWorkspaceSettingSource object` The value comes from a Slack workspace of the organization. - `BetaClaudeTagSlackParentChannelSettingSource object` The value comes from the channel that a code channel was started from. A parent channel contributes `instructions` and `environment_id` only. - `BetaClaudeTagSlackDefaultSettingSource object` The value comes from the organization's Slack defaults, which have no identifier. - `BetaClaudeTagDefaultSettingSource object` No settings level sets a value, and the built-in default applies. - `BetaClaudeTagSlackGridChannelSettingSource object` The value comes from the addressed channel as it is set up under another workspace of its Enterprise Grid: a channel shared across the Grid keeps one Slack channel identifier in every workspace that sees it. - `model: BetaClaudeTagSettingSource or null` The settings level `model` comes from. - `updated_at: string` Time Claude Tag's record of the channel last changed. It moves on every change to a setting, and can also move when something no response holds changes, so a later value says to read the channel again, not that a setting changed. Attaching or detaching a Bundle does not by itself move it. format: date-time #### Example ```bash curl https://api.anthropic.com/v1/organizations/claude_tag/slack_channels/$ID \ -H 'Content-Type: application/json' \ -H 'anthropic-version: 2026-10-21' \ -H 'anthropic-beta: experimental-claude-tag-2026-10-21' \ -H "Authorization: Bearer $ANTHROPIC_API_KEY" \ -d '{ "settings": {} }' ``` ##### Response (200) ```json { "id": "id", "created_at": "2019-12-27T18:11:19.117Z", "settings": { "enabled": true, "environment_id": "environment_id", "guest_policy": { "type": "allow" }, "instructions": "instructions", "model": "model" }, "slack": { "channel_id": "xx", "workspace_id": "xx" }, "sources": { "enabled": { "slack_channel_id": "slack_channel_id", "type": "slack_channel" }, "environment_id": { "slack_channel_id": "slack_channel_id", "type": "slack_channel" }, "guest_policy": { "slack_channel_id": "slack_channel_id", "type": "slack_channel" }, "instructions": [ { "slack_channel_id": "slack_channel_id", "type": "slack_channel" } ], "model": { "slack_channel_id": "slack_channel_id", "type": "slack_channel" } }, "type": "slack_channel", "updated_at": "2019-12-27T18:11:19.117Z" } ``` ### Remove Slack Channel **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. #### Path parameters - `id: string` The channel's identifier, starting with `slch_`. #### Headers - `"anthropic-version": optional string` The version of the Claude API you want to use. Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning?sdk_languages=http). - `"anthropic-beta": optional array of AnthropicBeta` This endpoint is in beta: requests must send `experimental-claude-tag-2026-10-21` in this header. - `string` - `"message-batches-2024-09-24"` - `"prompt-caching-2024-07-31"` - `"computer-use-2024-10-22"` - `"computer-use-2025-01-24"` - `"pdfs-2024-09-25"` - `"token-counting-2024-11-01"` - `"token-efficient-tools-2025-02-19"` - `"output-128k-2025-02-19"` - `"files-api-2025-04-14"` - `"mcp-client-2025-04-04"` - `"mcp-client-2025-11-20"` - `"dev-full-thinking-2025-05-14"` - `"interleaved-thinking-2025-05-14"` - `"code-execution-2025-05-22"` - `"extended-cache-ttl-2025-04-11"` - `"context-1m-2025-08-07"` - `"context-management-2025-06-27"` - `"model-context-window-exceeded-2025-08-26"` - `"skills-2025-10-02"` - `"fast-mode-2026-02-01"` - `"output-300k-2026-03-24"` - `"user-profiles-2026-03-24"` - `"user-profiles-2026-08-18"` - `"user-profiles-2026-09-04"` - `"advisor-tool-2026-03-01"` - `"managed-agents-2026-04-01"` - `"cache-diagnosis-2026-04-07"` - `"dreaming-2026-04-21"` - `"thinking-token-count-2026-05-13"` - `"server-side-fallback-2026-06-01"` - `"server-side-fallback-2026-07-01"` - `"fallback-credit-2026-06-01"` - `"fallback-credit-2026-07-01"` - `"agent-memory-2026-07-22"` - `"mid-conversation-tool-changes-2026-07-01"` - `"compact-2026-01-12"` - `"computer-use-2025-11-24"` - `"mcp-tunnels-2026-06-22"` - `"structured-outputs-2025-11-13"` - `"task-budgets-2026-03-13"` - `"thinking-display-updates-2026-08-18"` - `"ce-user-management-2026-07-13"` - `"mid-conversation-output-config-2026-07-01"` - `"thinking-binding-controls-2026-08-01"` - `"mid-conversation-system-clear-at-2026-08-21"` - `"compact-2026-09-04"` - `"inline-tools-2026-09-15"` - `"mcp-client-2026-09-15"` - `"ce-plugins-2026-09-01"` - `"spend-limit-reads-2026-09-26"` - `"telemetry-destinations-2026-08-11"` - `"webhooks-2026-10-07"` - `"message-threads-2026-08-12"` - `"analytics-usage-cost-2026-08-24"` - `"experimental-claude-tag-2026-10-21"` #### Returns - `BetaClaudeTagDeletedSlackChannel object` Confirms that a Slack channel was removed from Claude Tag. - `type: "slack_channel_deleted"` - `id: string` The removed channel's identifier. #### Example ```bash curl https://api.anthropic.com/v1/organizations/claude_tag/slack_channels/$ID \ -X DELETE \ -H 'anthropic-version: 2026-10-21' \ -H 'anthropic-beta: experimental-claude-tag-2026-10-21' \ -H "Authorization: Bearer $ANTHROPIC_API_KEY" ``` ##### Response (200) ```json { "id": "id", "type": "slack_channel_deleted" } ``` ## Claude Tag › Slack Workspaces ### List Slack Workspaces **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. A workspace of a Slack Enterprise Grid the organization has connected returns 404 until it is 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`. #### Query parameters - `include_inherited: optional boolean` When `true`, `settings` holds what applies in each workspace once the organization's Slack defaults are taken into account, and every member of `sources` names the level a value comes from. When `false` or left out, `settings` holds what each workspace itself stores. - `limit: optional number` Number of items to return per page, between 1 and 100. Defaults to 20. format: int32 - `page: optional string` Opaque cursor from a previous response's `next_page`. - `slack_workspace_id: optional string` Slack's identifier for one workspace, as in the workspace object's `slack.workspace_id`, not its `id`. With it `data` holds that workspace alone, or nothing when it is not set up. #### Headers - `"anthropic-version": optional string` The version of the Claude API you want to use. Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning?sdk_languages=http). - `"anthropic-beta": optional array of AnthropicBeta` This endpoint is in beta: requests must send `experimental-claude-tag-2026-10-21` in this header. - `string` - `"message-batches-2024-09-24"` - `"prompt-caching-2024-07-31"` - `"computer-use-2024-10-22"` - `"computer-use-2025-01-24"` - `"pdfs-2024-09-25"` - `"token-counting-2024-11-01"` - `"token-efficient-tools-2025-02-19"` - `"output-128k-2025-02-19"` - `"files-api-2025-04-14"` - `"mcp-client-2025-04-04"` - `"mcp-client-2025-11-20"` - `"dev-full-thinking-2025-05-14"` - `"interleaved-thinking-2025-05-14"` - `"code-execution-2025-05-22"` - `"extended-cache-ttl-2025-04-11"` - `"context-1m-2025-08-07"` - `"context-management-2025-06-27"` - `"model-context-window-exceeded-2025-08-26"` - `"skills-2025-10-02"` - `"fast-mode-2026-02-01"` - `"output-300k-2026-03-24"` - `"user-profiles-2026-03-24"` - `"user-profiles-2026-08-18"` - `"user-profiles-2026-09-04"` - `"advisor-tool-2026-03-01"` - `"managed-agents-2026-04-01"` - `"cache-diagnosis-2026-04-07"` - `"dreaming-2026-04-21"` - `"thinking-token-count-2026-05-13"` - `"server-side-fallback-2026-06-01"` - `"server-side-fallback-2026-07-01"` - `"fallback-credit-2026-06-01"` - `"fallback-credit-2026-07-01"` - `"agent-memory-2026-07-22"` - `"mid-conversation-tool-changes-2026-07-01"` - `"compact-2026-01-12"` - `"computer-use-2025-11-24"` - `"mcp-tunnels-2026-06-22"` - `"structured-outputs-2025-11-13"` - `"task-budgets-2026-03-13"` - `"thinking-display-updates-2026-08-18"` - `"ce-user-management-2026-07-13"` - `"mid-conversation-output-config-2026-07-01"` - `"thinking-binding-controls-2026-08-01"` - `"mid-conversation-system-clear-at-2026-08-21"` - `"compact-2026-09-04"` - `"inline-tools-2026-09-15"` - `"mcp-client-2026-09-15"` - `"ce-plugins-2026-09-01"` - `"spend-limit-reads-2026-09-26"` - `"telemetry-destinations-2026-08-11"` - `"webhooks-2026-10-07"` - `"message-threads-2026-08-12"` - `"analytics-usage-cost-2026-08-24"` - `"experimental-claude-tag-2026-10-21"` #### Returns - `data: array of BetaClaudeTagSlackWorkspace` Workspaces on this page, newest first. - `type: "slack_workspace"` - `id: string` The workspace's identifier. Starts with `slws_`. It does not change for as long as the workspace is set up. A workspace that is removed and set up again has a new one, and the old one keeps returning 404; look the workspace up by its Slack identifier for the new one. - `created_at: string` Time the workspace was set up, by whichever route. It does not change for as long as `id` does not. format: date-time - `settings: BetaClaudeTagSettings` What the workspace itself stores or, with `include_inherited`, what applies in it. `sources` says which. - `enabled: boolean or null` Whether Claude is on. The nearest settings level that sets it decides. - `environment_id: string or null` The environment Claude's sessions run in, starting with `env_`, or the identifier of a self-hosted runner pool, starting with `ccpool_`. The nearest settings level that sets it decides. - `guest_policy: BetaClaudeTagGuestPolicy or null` What Claude does in a channel while a Slack guest is in it. The nearest settings level that sets it decides. - `BetaClaudeTagGuestPolicyAllow object` Claude answers in the channel. - `type: "allow"` - `BetaClaudeTagGuestPolicyRestrict object` Claude does not answer in the channel. - `type: "restrict"` - `BetaClaudeTagGuestPolicyChannelOnly object` Claude answers with only the Bundles attached to the channel itself. - `type: "channel_only"` - `instructions: string or null` Instructions for Claude. Instructions add up: the text of every settings level that sets it is joined, broadest first. - `model: string or null` The model Claude uses: a model identifier or the name of a model line. The nearest settings level that sets it decides. When none does, Claude uses the product's default model. - `slack: BetaClaudeTagSlackWorkspaceIdentifiers` Slack's own identifier for the workspace. - `workspace_id: string` Slack's identifier for the workspace, starting with `T`, such as `T0123ABCD`. - `sources: BetaClaudeTagSettingSources` For each setting, the settings level its value in `settings` comes from. - `enabled: BetaClaudeTagSettingSource or null` The settings level `enabled` comes from. - `BetaClaudeTagSlackChannelSettingSource object` The value comes from the addressed Slack channel itself. - `type: "slack_channel"` - `slack_channel_id: string` The channel's identifier, starting with `slch_`. - `BetaClaudeTagSlackWorkspaceSettingSource object` The value comes from a Slack workspace of the organization. - `type: "slack_workspace"` - `slack_workspace_id: string` The workspace's identifier, starting with `slws_`. - `BetaClaudeTagSlackParentChannelSettingSource object` The value comes from the channel that a code channel was started from. A parent channel contributes `instructions` and `environment_id` only. - `type: "slack_parent_channel"` - `slack_channel_id: string` The parent channel's identifier, starting with `slch_`. - `BetaClaudeTagSlackDefaultSettingSource object` The value comes from the organization's Slack defaults, which have no identifier. - `type: "slack_default"` - `BetaClaudeTagDefaultSettingSource object` No settings level sets a value, and the built-in default applies. - `type: "default"` - `BetaClaudeTagSlackGridChannelSettingSource object` The value comes from the addressed channel as it is set up under another workspace of its Enterprise Grid: a channel shared across the Grid keeps one Slack channel identifier in every workspace that sees it. - `type: "slack_grid_channel"` - `slack: BetaClaudeTagSlackChannelIdentifiers` Slack's own identifiers for the channel under that other workspace. - `channel_id: string` Slack's identifier for the channel, starting with `C` or `G`, such as `C0456EFGH`. minLength: 2, maxLength: 32 - `workspace_id: string` Slack's identifier for the workspace the channel is in, starting with `T`, such as `T0123ABCD`. minLength: 2, maxLength: 32 - `environment_id: BetaClaudeTagSettingSource or null` The settings level `environment_id` comes from. - `guest_policy: BetaClaudeTagSettingSource or null` The settings level `guest_policy` comes from. - `instructions: array of BetaClaudeTagSettingSource` Every settings level that contributes text to `instructions`, broadest first, in the order their text is joined. Empty when none does. - `BetaClaudeTagSlackChannelSettingSource object` The value comes from the addressed Slack channel itself. - `BetaClaudeTagSlackWorkspaceSettingSource object` The value comes from a Slack workspace of the organization. - `BetaClaudeTagSlackParentChannelSettingSource object` The value comes from the channel that a code channel was started from. A parent channel contributes `instructions` and `environment_id` only. - `BetaClaudeTagSlackDefaultSettingSource object` The value comes from the organization's Slack defaults, which have no identifier. - `BetaClaudeTagDefaultSettingSource object` No settings level sets a value, and the built-in default applies. - `BetaClaudeTagSlackGridChannelSettingSource object` The value comes from the addressed channel as it is set up under another workspace of its Enterprise Grid: a channel shared across the Grid keeps one Slack channel identifier in every workspace that sees it. - `model: BetaClaudeTagSettingSource or null` The settings level `model` comes from. - `updated_at: string` Time Claude Tag's record of the workspace last changed. It moves on every change to a setting, and can also move when something no response holds changes, so a later value says to read the workspace again, not that a setting changed. Attaching or detaching a Bundle does not by itself move it. format: date-time - `next_page: string or null` Cursor for the next page. Null on the last page. #### Example ```bash curl https://api.anthropic.com/v1/organizations/claude_tag/slack_workspaces \ -H 'anthropic-version: 2026-10-21' \ -H 'anthropic-beta: experimental-claude-tag-2026-10-21' \ -H "Authorization: Bearer $ANTHROPIC_API_KEY" ``` ##### Response (200) ```json { "data": [ { "id": "id", "created_at": "2019-12-27T18:11:19.117Z", "settings": { "enabled": true, "environment_id": "environment_id", "guest_policy": { "type": "allow" }, "instructions": "instructions", "model": "model" }, "slack": { "workspace_id": "workspace_id" }, "sources": { "enabled": { "slack_channel_id": "slack_channel_id", "type": "slack_channel" }, "environment_id": { "slack_channel_id": "slack_channel_id", "type": "slack_channel" }, "guest_policy": { "slack_channel_id": "slack_channel_id", "type": "slack_channel" }, "instructions": [ { "slack_channel_id": "slack_channel_id", "type": "slack_channel" } ], "model": { "slack_channel_id": "slack_channel_id", "type": "slack_channel" } }, "type": "slack_workspace", "updated_at": "2019-12-27T18:11:19.117Z" } ], "next_page": "next_page" } ``` ### Get Slack Workspace **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. #### Path parameters - `id: string` The workspace's identifier, starting with `slws_`. #### Query parameters - `include_inherited: optional boolean` When `true`, `settings` holds what applies in the workspace once the organization's Slack defaults are taken into account, and every member of `sources` names the level a value comes from. When `false` or left out, `settings` holds what the workspace itself stores. #### Headers - `"anthropic-version": optional string` The version of the Claude API you want to use. Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning?sdk_languages=http). - `"anthropic-beta": optional array of AnthropicBeta` This endpoint is in beta: requests must send `experimental-claude-tag-2026-10-21` in this header. - `string` - `"message-batches-2024-09-24"` - `"prompt-caching-2024-07-31"` - `"computer-use-2024-10-22"` - `"computer-use-2025-01-24"` - `"pdfs-2024-09-25"` - `"token-counting-2024-11-01"` - `"token-efficient-tools-2025-02-19"` - `"output-128k-2025-02-19"` - `"files-api-2025-04-14"` - `"mcp-client-2025-04-04"` - `"mcp-client-2025-11-20"` - `"dev-full-thinking-2025-05-14"` - `"interleaved-thinking-2025-05-14"` - `"code-execution-2025-05-22"` - `"extended-cache-ttl-2025-04-11"` - `"context-1m-2025-08-07"` - `"context-management-2025-06-27"` - `"model-context-window-exceeded-2025-08-26"` - `"skills-2025-10-02"` - `"fast-mode-2026-02-01"` - `"output-300k-2026-03-24"` - `"user-profiles-2026-03-24"` - `"user-profiles-2026-08-18"` - `"user-profiles-2026-09-04"` - `"advisor-tool-2026-03-01"` - `"managed-agents-2026-04-01"` - `"cache-diagnosis-2026-04-07"` - `"dreaming-2026-04-21"` - `"thinking-token-count-2026-05-13"` - `"server-side-fallback-2026-06-01"` - `"server-side-fallback-2026-07-01"` - `"fallback-credit-2026-06-01"` - `"fallback-credit-2026-07-01"` - `"agent-memory-2026-07-22"` - `"mid-conversation-tool-changes-2026-07-01"` - `"compact-2026-01-12"` - `"computer-use-2025-11-24"` - `"mcp-tunnels-2026-06-22"` - `"structured-outputs-2025-11-13"` - `"task-budgets-2026-03-13"` - `"thinking-display-updates-2026-08-18"` - `"ce-user-management-2026-07-13"` - `"mid-conversation-output-config-2026-07-01"` - `"thinking-binding-controls-2026-08-01"` - `"mid-conversation-system-clear-at-2026-08-21"` - `"compact-2026-09-04"` - `"inline-tools-2026-09-15"` - `"mcp-client-2026-09-15"` - `"ce-plugins-2026-09-01"` - `"spend-limit-reads-2026-09-26"` - `"telemetry-destinations-2026-08-11"` - `"webhooks-2026-10-07"` - `"message-threads-2026-08-12"` - `"analytics-usage-cost-2026-08-24"` - `"experimental-claude-tag-2026-10-21"` #### Returns - `BetaClaudeTagSlackWorkspace object` A Slack workspace the organization has connected, itself or through its Slack Enterprise Grid, with the settings it stores or, with `include_inherited`, the settings that apply in it. - `type: "slack_workspace"` - `id: string` The workspace's identifier. Starts with `slws_`. It does not change for as long as the workspace is set up. A workspace that is removed and set up again has a new one, and the old one keeps returning 404; look the workspace up by its Slack identifier for the new one. - `created_at: string` Time the workspace was set up, by whichever route. It does not change for as long as `id` does not. format: date-time - `settings: BetaClaudeTagSettings` What the workspace itself stores or, with `include_inherited`, what applies in it. `sources` says which. - `enabled: boolean or null` Whether Claude is on. The nearest settings level that sets it decides. - `environment_id: string or null` The environment Claude's sessions run in, starting with `env_`, or the identifier of a self-hosted runner pool, starting with `ccpool_`. The nearest settings level that sets it decides. - `guest_policy: BetaClaudeTagGuestPolicy or null` What Claude does in a channel while a Slack guest is in it. The nearest settings level that sets it decides. - `BetaClaudeTagGuestPolicyAllow object` Claude answers in the channel. - `type: "allow"` - `BetaClaudeTagGuestPolicyRestrict object` Claude does not answer in the channel. - `type: "restrict"` - `BetaClaudeTagGuestPolicyChannelOnly object` Claude answers with only the Bundles attached to the channel itself. - `type: "channel_only"` - `instructions: string or null` Instructions for Claude. Instructions add up: the text of every settings level that sets it is joined, broadest first. - `model: string or null` The model Claude uses: a model identifier or the name of a model line. The nearest settings level that sets it decides. When none does, Claude uses the product's default model. - `slack: BetaClaudeTagSlackWorkspaceIdentifiers` Slack's own identifier for the workspace. - `workspace_id: string` Slack's identifier for the workspace, starting with `T`, such as `T0123ABCD`. - `sources: BetaClaudeTagSettingSources` For each setting, the settings level its value in `settings` comes from. - `enabled: BetaClaudeTagSettingSource or null` The settings level `enabled` comes from. - `BetaClaudeTagSlackChannelSettingSource object` The value comes from the addressed Slack channel itself. - `type: "slack_channel"` - `slack_channel_id: string` The channel's identifier, starting with `slch_`. - `BetaClaudeTagSlackWorkspaceSettingSource object` The value comes from a Slack workspace of the organization. - `type: "slack_workspace"` - `slack_workspace_id: string` The workspace's identifier, starting with `slws_`. - `BetaClaudeTagSlackParentChannelSettingSource object` The value comes from the channel that a code channel was started from. A parent channel contributes `instructions` and `environment_id` only. - `type: "slack_parent_channel"` - `slack_channel_id: string` The parent channel's identifier, starting with `slch_`. - `BetaClaudeTagSlackDefaultSettingSource object` The value comes from the organization's Slack defaults, which have no identifier. - `type: "slack_default"` - `BetaClaudeTagDefaultSettingSource object` No settings level sets a value, and the built-in default applies. - `type: "default"` - `BetaClaudeTagSlackGridChannelSettingSource object` The value comes from the addressed channel as it is set up under another workspace of its Enterprise Grid: a channel shared across the Grid keeps one Slack channel identifier in every workspace that sees it. - `type: "slack_grid_channel"` - `slack: BetaClaudeTagSlackChannelIdentifiers` Slack's own identifiers for the channel under that other workspace. - `channel_id: string` Slack's identifier for the channel, starting with `C` or `G`, such as `C0456EFGH`. minLength: 2, maxLength: 32 - `workspace_id: string` Slack's identifier for the workspace the channel is in, starting with `T`, such as `T0123ABCD`. minLength: 2, maxLength: 32 - `environment_id: BetaClaudeTagSettingSource or null` The settings level `environment_id` comes from. - `guest_policy: BetaClaudeTagSettingSource or null` The settings level `guest_policy` comes from. - `instructions: array of BetaClaudeTagSettingSource` Every settings level that contributes text to `instructions`, broadest first, in the order their text is joined. Empty when none does. - `BetaClaudeTagSlackChannelSettingSource object` The value comes from the addressed Slack channel itself. - `BetaClaudeTagSlackWorkspaceSettingSource object` The value comes from a Slack workspace of the organization. - `BetaClaudeTagSlackParentChannelSettingSource object` The value comes from the channel that a code channel was started from. A parent channel contributes `instructions` and `environment_id` only. - `BetaClaudeTagSlackDefaultSettingSource object` The value comes from the organization's Slack defaults, which have no identifier. - `BetaClaudeTagDefaultSettingSource object` No settings level sets a value, and the built-in default applies. - `BetaClaudeTagSlackGridChannelSettingSource object` The value comes from the addressed channel as it is set up under another workspace of its Enterprise Grid: a channel shared across the Grid keeps one Slack channel identifier in every workspace that sees it. - `model: BetaClaudeTagSettingSource or null` The settings level `model` comes from. - `updated_at: string` Time Claude Tag's record of the workspace last changed. It moves on every change to a setting, and can also move when something no response holds changes, so a later value says to read the workspace again, not that a setting changed. Attaching or detaching a Bundle does not by itself move it. format: date-time #### Example ```bash curl https://api.anthropic.com/v1/organizations/claude_tag/slack_workspaces/$ID \ -H 'anthropic-version: 2026-10-21' \ -H 'anthropic-beta: experimental-claude-tag-2026-10-21' \ -H "Authorization: Bearer $ANTHROPIC_API_KEY" ``` ##### Response (200) ```json { "id": "id", "created_at": "2019-12-27T18:11:19.117Z", "settings": { "enabled": true, "environment_id": "environment_id", "guest_policy": { "type": "allow" }, "instructions": "instructions", "model": "model" }, "slack": { "workspace_id": "workspace_id" }, "sources": { "enabled": { "slack_channel_id": "slack_channel_id", "type": "slack_channel" }, "environment_id": { "slack_channel_id": "slack_channel_id", "type": "slack_channel" }, "guest_policy": { "slack_channel_id": "slack_channel_id", "type": "slack_channel" }, "instructions": [ { "slack_channel_id": "slack_channel_id", "type": "slack_channel" } ], "model": { "slack_channel_id": "slack_channel_id", "type": "slack_channel" } }, "type": "slack_workspace", "updated_at": "2019-12-27T18:11:19.117Z" } ``` ### Update Slack Workspace **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. #### Path parameters - `id: string` The workspace's identifier, starting with `slws_`. #### Headers - `"anthropic-version": optional string` The version of the Claude API you want to use. Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning?sdk_languages=http). - `"anthropic-beta": optional array of AnthropicBeta` This endpoint is in beta: requests must send `experimental-claude-tag-2026-10-21` in this header. - `string` - `"message-batches-2024-09-24"` - `"prompt-caching-2024-07-31"` - `"computer-use-2024-10-22"` - `"computer-use-2025-01-24"` - `"pdfs-2024-09-25"` - `"token-counting-2024-11-01"` - `"token-efficient-tools-2025-02-19"` - `"output-128k-2025-02-19"` - `"files-api-2025-04-14"` - `"mcp-client-2025-04-04"` - `"mcp-client-2025-11-20"` - `"dev-full-thinking-2025-05-14"` - `"interleaved-thinking-2025-05-14"` - `"code-execution-2025-05-22"` - `"extended-cache-ttl-2025-04-11"` - `"context-1m-2025-08-07"` - `"context-management-2025-06-27"` - `"model-context-window-exceeded-2025-08-26"` - `"skills-2025-10-02"` - `"fast-mode-2026-02-01"` - `"output-300k-2026-03-24"` - `"user-profiles-2026-03-24"` - `"user-profiles-2026-08-18"` - `"user-profiles-2026-09-04"` - `"advisor-tool-2026-03-01"` - `"managed-agents-2026-04-01"` - `"cache-diagnosis-2026-04-07"` - `"dreaming-2026-04-21"` - `"thinking-token-count-2026-05-13"` - `"server-side-fallback-2026-06-01"` - `"server-side-fallback-2026-07-01"` - `"fallback-credit-2026-06-01"` - `"fallback-credit-2026-07-01"` - `"agent-memory-2026-07-22"` - `"mid-conversation-tool-changes-2026-07-01"` - `"compact-2026-01-12"` - `"computer-use-2025-11-24"` - `"mcp-tunnels-2026-06-22"` - `"structured-outputs-2025-11-13"` - `"task-budgets-2026-03-13"` - `"thinking-display-updates-2026-08-18"` - `"ce-user-management-2026-07-13"` - `"mid-conversation-output-config-2026-07-01"` - `"thinking-binding-controls-2026-08-01"` - `"mid-conversation-system-clear-at-2026-08-21"` - `"compact-2026-09-04"` - `"inline-tools-2026-09-15"` - `"mcp-client-2026-09-15"` - `"ce-plugins-2026-09-01"` - `"spend-limit-reads-2026-09-26"` - `"telemetry-destinations-2026-08-11"` - `"webhooks-2026-10-07"` - `"message-threads-2026-08-12"` - `"analytics-usage-cost-2026-08-24"` - `"experimental-claude-tag-2026-10-21"` #### Body parameters - `settings: BetaClaudeTagSettingsUpdate` The settings to change. - `enabled: optional boolean or null` Whether Claude is on. `true` on a channel turns Claude on in it even when its workspace stores `false`. Null clears it. - `environment_id: optional string or null` The environment Claude's sessions run in: the identifier of an active environment of the organization, starting with `env_`. Null clears it. minLength: 1, maxLength: 64 - `guest_policy: optional BetaClaudeTagGuestPolicy or null` What Claude does in a channel while a Slack guest is in it. Null clears it. - `BetaClaudeTagGuestPolicyAllow object` Claude answers in the channel. - `type: "allow"` - `BetaClaudeTagGuestPolicyRestrict object` Claude does not answer in the channel. - `type: "restrict"` - `BetaClaudeTagGuestPolicyChannelOnly object` Claude answers with only the Bundles attached to the channel itself. - `type: "channel_only"` - `instructions: optional string or null` Instructions for Claude, up to 8,192 characters after leading and trailing white space is trimmed. Null or blank text clears them. - `model: optional string or null` The model Claude uses: the identifier of a model, or the name of a model line, that the organization is entitled to for Claude Tag. Null clears it. minLength: 1, maxLength: 128 #### Returns - `BetaClaudeTagSlackWorkspace object` A Slack workspace the organization has connected, itself or through its Slack Enterprise Grid, with the settings it stores or, with `include_inherited`, the settings that apply in it. - `type: "slack_workspace"` - `id: string` The workspace's identifier. Starts with `slws_`. It does not change for as long as the workspace is set up. A workspace that is removed and set up again has a new one, and the old one keeps returning 404; look the workspace up by its Slack identifier for the new one. - `created_at: string` Time the workspace was set up, by whichever route. It does not change for as long as `id` does not. format: date-time - `settings: BetaClaudeTagSettings` What the workspace itself stores or, with `include_inherited`, what applies in it. `sources` says which. - `enabled: boolean or null` Whether Claude is on. The nearest settings level that sets it decides. - `environment_id: string or null` The environment Claude's sessions run in, starting with `env_`, or the identifier of a self-hosted runner pool, starting with `ccpool_`. The nearest settings level that sets it decides. - `guest_policy: BetaClaudeTagGuestPolicy or null` What Claude does in a channel while a Slack guest is in it. The nearest settings level that sets it decides. - `BetaClaudeTagGuestPolicyAllow object` Claude answers in the channel. - `type: "allow"` - `BetaClaudeTagGuestPolicyRestrict object` Claude does not answer in the channel. - `type: "restrict"` - `BetaClaudeTagGuestPolicyChannelOnly object` Claude answers with only the Bundles attached to the channel itself. - `type: "channel_only"` - `instructions: string or null` Instructions for Claude. Instructions add up: the text of every settings level that sets it is joined, broadest first. - `model: string or null` The model Claude uses: a model identifier or the name of a model line. The nearest settings level that sets it decides. When none does, Claude uses the product's default model. - `slack: BetaClaudeTagSlackWorkspaceIdentifiers` Slack's own identifier for the workspace. - `workspace_id: string` Slack's identifier for the workspace, starting with `T`, such as `T0123ABCD`. - `sources: BetaClaudeTagSettingSources` For each setting, the settings level its value in `settings` comes from. - `enabled: BetaClaudeTagSettingSource or null` The settings level `enabled` comes from. - `BetaClaudeTagSlackChannelSettingSource object` The value comes from the addressed Slack channel itself. - `type: "slack_channel"` - `slack_channel_id: string` The channel's identifier, starting with `slch_`. - `BetaClaudeTagSlackWorkspaceSettingSource object` The value comes from a Slack workspace of the organization. - `type: "slack_workspace"` - `slack_workspace_id: string` The workspace's identifier, starting with `slws_`. - `BetaClaudeTagSlackParentChannelSettingSource object` The value comes from the channel that a code channel was started from. A parent channel contributes `instructions` and `environment_id` only. - `type: "slack_parent_channel"` - `slack_channel_id: string` The parent channel's identifier, starting with `slch_`. - `BetaClaudeTagSlackDefaultSettingSource object` The value comes from the organization's Slack defaults, which have no identifier. - `type: "slack_default"` - `BetaClaudeTagDefaultSettingSource object` No settings level sets a value, and the built-in default applies. - `type: "default"` - `BetaClaudeTagSlackGridChannelSettingSource object` The value comes from the addressed channel as it is set up under another workspace of its Enterprise Grid: a channel shared across the Grid keeps one Slack channel identifier in every workspace that sees it. - `type: "slack_grid_channel"` - `slack: BetaClaudeTagSlackChannelIdentifiers` Slack's own identifiers for the channel under that other workspace. - `channel_id: string` Slack's identifier for the channel, starting with `C` or `G`, such as `C0456EFGH`. minLength: 2, maxLength: 32 - `workspace_id: string` Slack's identifier for the workspace the channel is in, starting with `T`, such as `T0123ABCD`. minLength: 2, maxLength: 32 - `environment_id: BetaClaudeTagSettingSource or null` The settings level `environment_id` comes from. - `guest_policy: BetaClaudeTagSettingSource or null` The settings level `guest_policy` comes from. - `instructions: array of BetaClaudeTagSettingSource` Every settings level that contributes text to `instructions`, broadest first, in the order their text is joined. Empty when none does. - `BetaClaudeTagSlackChannelSettingSource object` The value comes from the addressed Slack channel itself. - `BetaClaudeTagSlackWorkspaceSettingSource object` The value comes from a Slack workspace of the organization. - `BetaClaudeTagSlackParentChannelSettingSource object` The value comes from the channel that a code channel was started from. A parent channel contributes `instructions` and `environment_id` only. - `BetaClaudeTagSlackDefaultSettingSource object` The value comes from the organization's Slack defaults, which have no identifier. - `BetaClaudeTagDefaultSettingSource object` No settings level sets a value, and the built-in default applies. - `BetaClaudeTagSlackGridChannelSettingSource object` The value comes from the addressed channel as it is set up under another workspace of its Enterprise Grid: a channel shared across the Grid keeps one Slack channel identifier in every workspace that sees it. - `model: BetaClaudeTagSettingSource or null` The settings level `model` comes from. - `updated_at: string` Time Claude Tag's record of the workspace last changed. It moves on every change to a setting, and can also move when something no response holds changes, so a later value says to read the workspace again, not that a setting changed. Attaching or detaching a Bundle does not by itself move it. format: date-time #### Example ```bash curl https://api.anthropic.com/v1/organizations/claude_tag/slack_workspaces/$ID \ -H 'Content-Type: application/json' \ -H 'anthropic-version: 2026-10-21' \ -H 'anthropic-beta: experimental-claude-tag-2026-10-21' \ -H "Authorization: Bearer $ANTHROPIC_API_KEY" \ -d '{ "settings": {} }' ``` ##### Response (200) ```json { "id": "id", "created_at": "2019-12-27T18:11:19.117Z", "settings": { "enabled": true, "environment_id": "environment_id", "guest_policy": { "type": "allow" }, "instructions": "instructions", "model": "model" }, "slack": { "workspace_id": "workspace_id" }, "sources": { "enabled": { "slack_channel_id": "slack_channel_id", "type": "slack_channel" }, "environment_id": { "slack_channel_id": "slack_channel_id", "type": "slack_channel" }, "guest_policy": { "slack_channel_id": "slack_channel_id", "type": "slack_channel" }, "instructions": [ { "slack_channel_id": "slack_channel_id", "type": "slack_channel" } ], "model": { "slack_channel_id": "slack_channel_id", "type": "slack_channel" } }, "type": "slack_workspace", "updated_at": "2019-12-27T18:11:19.117Z" } ``` ## Claude Tag › Bundles ### List Bundles **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. #### Query parameters - `limit: optional number` Number of items to return per page, between 1 and 100. Defaults to 20. format: int32 - `page: optional string` Opaque cursor from a previous response's `next_page`. #### Headers - `"anthropic-version": optional string` The version of the Claude API you want to use. Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning?sdk_languages=http). - `"anthropic-beta": optional array of AnthropicBeta` This endpoint is in beta: requests must send `experimental-claude-tag-2026-10-21` in this header. - `string` - `"message-batches-2024-09-24"` - `"prompt-caching-2024-07-31"` - `"computer-use-2024-10-22"` - `"computer-use-2025-01-24"` - `"pdfs-2024-09-25"` - `"token-counting-2024-11-01"` - `"token-efficient-tools-2025-02-19"` - `"output-128k-2025-02-19"` - `"files-api-2025-04-14"` - `"mcp-client-2025-04-04"` - `"mcp-client-2025-11-20"` - `"dev-full-thinking-2025-05-14"` - `"interleaved-thinking-2025-05-14"` - `"code-execution-2025-05-22"` - `"extended-cache-ttl-2025-04-11"` - `"context-1m-2025-08-07"` - `"context-management-2025-06-27"` - `"model-context-window-exceeded-2025-08-26"` - `"skills-2025-10-02"` - `"fast-mode-2026-02-01"` - `"output-300k-2026-03-24"` - `"user-profiles-2026-03-24"` - `"user-profiles-2026-08-18"` - `"user-profiles-2026-09-04"` - `"advisor-tool-2026-03-01"` - `"managed-agents-2026-04-01"` - `"cache-diagnosis-2026-04-07"` - `"dreaming-2026-04-21"` - `"thinking-token-count-2026-05-13"` - `"server-side-fallback-2026-06-01"` - `"server-side-fallback-2026-07-01"` - `"fallback-credit-2026-06-01"` - `"fallback-credit-2026-07-01"` - `"agent-memory-2026-07-22"` - `"mid-conversation-tool-changes-2026-07-01"` - `"compact-2026-01-12"` - `"computer-use-2025-11-24"` - `"mcp-tunnels-2026-06-22"` - `"structured-outputs-2025-11-13"` - `"task-budgets-2026-03-13"` - `"thinking-display-updates-2026-08-18"` - `"ce-user-management-2026-07-13"` - `"mid-conversation-output-config-2026-07-01"` - `"thinking-binding-controls-2026-08-01"` - `"mid-conversation-system-clear-at-2026-08-21"` - `"compact-2026-09-04"` - `"inline-tools-2026-09-15"` - `"mcp-client-2026-09-15"` - `"ce-plugins-2026-09-01"` - `"spend-limit-reads-2026-09-26"` - `"telemetry-destinations-2026-08-11"` - `"webhooks-2026-10-07"` - `"message-threads-2026-08-12"` - `"analytics-usage-cost-2026-08-24"` - `"experimental-claude-tag-2026-10-21"` #### Returns - `data: array of BetaClaudeTagBundle` Bundles on this page, newest first. - `type: "bundle"` - `id: string` The Bundle's identifier. Starts with `capp_`. - `created_at: string` Time the Bundle was created. format: date-time - `description: string or null` What the Bundle is for. Null when it has none. Read-only. - `display_name: string` The Bundle's name. Always set. Read-only. - `updated_at: string` Time of the last change to the Bundle. format: date-time - `next_page: string or null` Cursor for the next page. Null on the last page. #### Example ```bash curl https://api.anthropic.com/v1/organizations/claude_tag/bundles \ -H 'anthropic-version: 2026-10-21' \ -H 'anthropic-beta: experimental-claude-tag-2026-10-21' \ -H "Authorization: Bearer $ANTHROPIC_API_KEY" ``` ##### Response (200) ```json { "data": [ { "id": "id", "created_at": "2019-12-27T18:11:19.117Z", "description": "description", "display_name": "display_name", "type": "bundle", "updated_at": "2019-12-27T18:11:19.117Z" } ], "next_page": "next_page" } ``` ### Get Bundle **GET** `/v1/organizations/claude_tag/bundles/{bundle_id}` Get one Bundle. What the Bundle grants (connectors, repositories and credentials) is never returned. #### Path parameters - `bundle_id: string` The Bundle's identifier, starting with `capp_`. #### Headers - `"anthropic-version": optional string` The version of the Claude API you want to use. Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning?sdk_languages=http). - `"anthropic-beta": optional array of AnthropicBeta` This endpoint is in beta: requests must send `experimental-claude-tag-2026-10-21` in this header. - `string` - `"message-batches-2024-09-24"` - `"prompt-caching-2024-07-31"` - `"computer-use-2024-10-22"` - `"computer-use-2025-01-24"` - `"pdfs-2024-09-25"` - `"token-counting-2024-11-01"` - `"token-efficient-tools-2025-02-19"` - `"output-128k-2025-02-19"` - `"files-api-2025-04-14"` - `"mcp-client-2025-04-04"` - `"mcp-client-2025-11-20"` - `"dev-full-thinking-2025-05-14"` - `"interleaved-thinking-2025-05-14"` - `"code-execution-2025-05-22"` - `"extended-cache-ttl-2025-04-11"` - `"context-1m-2025-08-07"` - `"context-management-2025-06-27"` - `"model-context-window-exceeded-2025-08-26"` - `"skills-2025-10-02"` - `"fast-mode-2026-02-01"` - `"output-300k-2026-03-24"` - `"user-profiles-2026-03-24"` - `"user-profiles-2026-08-18"` - `"user-profiles-2026-09-04"` - `"advisor-tool-2026-03-01"` - `"managed-agents-2026-04-01"` - `"cache-diagnosis-2026-04-07"` - `"dreaming-2026-04-21"` - `"thinking-token-count-2026-05-13"` - `"server-side-fallback-2026-06-01"` - `"server-side-fallback-2026-07-01"` - `"fallback-credit-2026-06-01"` - `"fallback-credit-2026-07-01"` - `"agent-memory-2026-07-22"` - `"mid-conversation-tool-changes-2026-07-01"` - `"compact-2026-01-12"` - `"computer-use-2025-11-24"` - `"mcp-tunnels-2026-06-22"` - `"structured-outputs-2025-11-13"` - `"task-budgets-2026-03-13"` - `"thinking-display-updates-2026-08-18"` - `"ce-user-management-2026-07-13"` - `"mid-conversation-output-config-2026-07-01"` - `"thinking-binding-controls-2026-08-01"` - `"mid-conversation-system-clear-at-2026-08-21"` - `"compact-2026-09-04"` - `"inline-tools-2026-09-15"` - `"mcp-client-2026-09-15"` - `"ce-plugins-2026-09-01"` - `"spend-limit-reads-2026-09-26"` - `"telemetry-destinations-2026-08-11"` - `"webhooks-2026-10-07"` - `"message-threads-2026-08-12"` - `"analytics-usage-cost-2026-08-24"` - `"experimental-claude-tag-2026-10-21"` #### Returns - `BetaClaudeTagBundle object` A named set of access that Claude can use in a Slack channel or a Slack workspace: connectors, repositories and credentials. Created and edited in claude.ai. - `type: "bundle"` - `id: string` The Bundle's identifier. Starts with `capp_`. - `created_at: string` Time the Bundle was created. format: date-time - `description: string or null` What the Bundle is for. Null when it has none. Read-only. - `display_name: string` The Bundle's name. Always set. Read-only. - `updated_at: string` Time of the last change to the Bundle. format: date-time #### Example ```bash curl https://api.anthropic.com/v1/organizations/claude_tag/bundles/$BUNDLE_ID \ -H 'anthropic-version: 2026-10-21' \ -H 'anthropic-beta: experimental-claude-tag-2026-10-21' \ -H "Authorization: Bearer $ANTHROPIC_API_KEY" ``` ##### Response (200) ```json { "id": "id", "created_at": "2019-12-27T18:11:19.117Z", "description": "description", "display_name": "display_name", "type": "bundle", "updated_at": "2019-12-27T18:11:19.117Z" } ``` ## Claude Tag › Bundles › Targets ### List Bundle Targets **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. #### Path parameters - `bundle_id: string` The Bundle's identifier, starting with `capp_`. #### Query parameters - `limit: optional number` Number of items to return per page, between 1 and 100. Defaults to 20. format: int32 - `page: optional string` Opaque cursor from a previous response's `next_page`. #### Headers - `"anthropic-version": optional string` The version of the Claude API you want to use. Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning?sdk_languages=http). - `"anthropic-beta": optional array of AnthropicBeta` This endpoint is in beta: requests must send `experimental-claude-tag-2026-10-21` in this header. - `string` - `"message-batches-2024-09-24"` - `"prompt-caching-2024-07-31"` - `"computer-use-2024-10-22"` - `"computer-use-2025-01-24"` - `"pdfs-2024-09-25"` - `"token-counting-2024-11-01"` - `"token-efficient-tools-2025-02-19"` - `"output-128k-2025-02-19"` - `"files-api-2025-04-14"` - `"mcp-client-2025-04-04"` - `"mcp-client-2025-11-20"` - `"dev-full-thinking-2025-05-14"` - `"interleaved-thinking-2025-05-14"` - `"code-execution-2025-05-22"` - `"extended-cache-ttl-2025-04-11"` - `"context-1m-2025-08-07"` - `"context-management-2025-06-27"` - `"model-context-window-exceeded-2025-08-26"` - `"skills-2025-10-02"` - `"fast-mode-2026-02-01"` - `"output-300k-2026-03-24"` - `"user-profiles-2026-03-24"` - `"user-profiles-2026-08-18"` - `"user-profiles-2026-09-04"` - `"advisor-tool-2026-03-01"` - `"managed-agents-2026-04-01"` - `"cache-diagnosis-2026-04-07"` - `"dreaming-2026-04-21"` - `"thinking-token-count-2026-05-13"` - `"server-side-fallback-2026-06-01"` - `"server-side-fallback-2026-07-01"` - `"fallback-credit-2026-06-01"` - `"fallback-credit-2026-07-01"` - `"agent-memory-2026-07-22"` - `"mid-conversation-tool-changes-2026-07-01"` - `"compact-2026-01-12"` - `"computer-use-2025-11-24"` - `"mcp-tunnels-2026-06-22"` - `"structured-outputs-2025-11-13"` - `"task-budgets-2026-03-13"` - `"thinking-display-updates-2026-08-18"` - `"ce-user-management-2026-07-13"` - `"mid-conversation-output-config-2026-07-01"` - `"thinking-binding-controls-2026-08-01"` - `"mid-conversation-system-clear-at-2026-08-21"` - `"compact-2026-09-04"` - `"inline-tools-2026-09-15"` - `"mcp-client-2026-09-15"` - `"ce-plugins-2026-09-01"` - `"spend-limit-reads-2026-09-26"` - `"telemetry-destinations-2026-08-11"` - `"webhooks-2026-10-07"` - `"message-threads-2026-08-12"` - `"analytics-usage-cost-2026-08-24"` - `"experimental-claude-tag-2026-10-21"` #### Returns - `data: array of BetaClaudeTagBundleTarget` Bundle Targets on this page, newest first. - `BetaClaudeTagSlackChannelBundleTarget object` One Bundle attached to one Slack channel. The Bundle can be used in that channel only. - `type: "slack_channel"` - `id: string` The Bundle Target's identifier. Starts with `btgt_`. No two Bundle Targets have the same one, and the same Bundle and target always give the same one, also after a detach and a new attach. It is opaque. - `created_at: string` Time the Bundle was attached. format: date-time - `slack_channel_id: string` The identifier of the Slack channel the Bundle is attached to, starting with `slch_`. It is the channel object's `id`, not Slack's `channel_id`. - `BetaClaudeTagSlackWorkspaceBundleTarget object` One Bundle attached to one Slack workspace. The Bundle can be used in the workspace and in every channel in it. - `type: "slack_workspace"` - `id: string` The Bundle Target's identifier. Starts with `btgt_`. No two Bundle Targets have the same one, and the same Bundle and target always give the same one, also after a detach and a new attach. It is opaque. - `created_at: string` Time the Bundle was attached. format: date-time - `slack_workspace_id: string` The identifier of the Slack workspace the Bundle is attached to, starting with `slws_`. - `next_page: string or null` Cursor for the next page. Null on the last page. #### Example ```bash curl https://api.anthropic.com/v1/organizations/claude_tag/bundles/$BUNDLE_ID/targets \ -H 'anthropic-version: 2026-10-21' \ -H 'anthropic-beta: experimental-claude-tag-2026-10-21' \ -H "Authorization: Bearer $ANTHROPIC_API_KEY" ``` ##### Response (200) ```json { "data": [ { "id": "id", "created_at": "2019-12-27T18:11:19.117Z", "slack_channel_id": "slack_channel_id", "type": "slack_channel" } ], "next_page": "next_page" } ``` ### Attach Bundle **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. #### Path parameters - `bundle_id: string` The Bundle's identifier, starting with `capp_`. #### Headers - `"anthropic-version": optional string` The version of the Claude API you want to use. Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning?sdk_languages=http). - `"anthropic-beta": optional array of AnthropicBeta` This endpoint is in beta: requests must send `experimental-claude-tag-2026-10-21` in this header. - `string` - `"message-batches-2024-09-24"` - `"prompt-caching-2024-07-31"` - `"computer-use-2024-10-22"` - `"computer-use-2025-01-24"` - `"pdfs-2024-09-25"` - `"token-counting-2024-11-01"` - `"token-efficient-tools-2025-02-19"` - `"output-128k-2025-02-19"` - `"files-api-2025-04-14"` - `"mcp-client-2025-04-04"` - `"mcp-client-2025-11-20"` - `"dev-full-thinking-2025-05-14"` - `"interleaved-thinking-2025-05-14"` - `"code-execution-2025-05-22"` - `"extended-cache-ttl-2025-04-11"` - `"context-1m-2025-08-07"` - `"context-management-2025-06-27"` - `"model-context-window-exceeded-2025-08-26"` - `"skills-2025-10-02"` - `"fast-mode-2026-02-01"` - `"output-300k-2026-03-24"` - `"user-profiles-2026-03-24"` - `"user-profiles-2026-08-18"` - `"user-profiles-2026-09-04"` - `"advisor-tool-2026-03-01"` - `"managed-agents-2026-04-01"` - `"cache-diagnosis-2026-04-07"` - `"dreaming-2026-04-21"` - `"thinking-token-count-2026-05-13"` - `"server-side-fallback-2026-06-01"` - `"server-side-fallback-2026-07-01"` - `"fallback-credit-2026-06-01"` - `"fallback-credit-2026-07-01"` - `"agent-memory-2026-07-22"` - `"mid-conversation-tool-changes-2026-07-01"` - `"compact-2026-01-12"` - `"computer-use-2025-11-24"` - `"mcp-tunnels-2026-06-22"` - `"structured-outputs-2025-11-13"` - `"task-budgets-2026-03-13"` - `"thinking-display-updates-2026-08-18"` - `"ce-user-management-2026-07-13"` - `"mid-conversation-output-config-2026-07-01"` - `"thinking-binding-controls-2026-08-01"` - `"mid-conversation-system-clear-at-2026-08-21"` - `"compact-2026-09-04"` - `"inline-tools-2026-09-15"` - `"mcp-client-2026-09-15"` - `"ce-plugins-2026-09-01"` - `"spend-limit-reads-2026-09-26"` - `"telemetry-destinations-2026-08-11"` - `"webhooks-2026-10-07"` - `"message-threads-2026-08-12"` - `"analytics-usage-cost-2026-08-24"` - `"experimental-claude-tag-2026-10-21"` #### Body parameters - `target: BetaClaudeTagBundleTargetCreate` - `BetaClaudeTagSlackChannelBundleTargetCreate object` Attach the Bundle to a Slack channel. - `type: "slack_channel"` - `slack_channel_id: string` The identifier of the Slack channel to attach the Bundle to, starting with `slch_`. It is the channel object's `id`, not Slack's `channel_id`. minLength: 8, maxLength: 64 - `BetaClaudeTagSlackWorkspaceBundleTargetCreate object` Attach the Bundle to a Slack workspace. - `type: "slack_workspace"` - `slack_workspace_id: string` The identifier of the Slack workspace to attach the Bundle to, starting with `slws_`. minLength: 8, maxLength: 64 #### Returns - `BetaClaudeTagBundleTarget = BetaClaudeTagSlackChannelBundleTarget or BetaClaudeTagSlackWorkspaceBundleTarget` One Bundle attached to one Slack channel or one Slack workspace. More types of target can be added. - `BetaClaudeTagSlackChannelBundleTarget object` One Bundle attached to one Slack channel. The Bundle can be used in that channel only. - `type: "slack_channel"` - `id: string` The Bundle Target's identifier. Starts with `btgt_`. No two Bundle Targets have the same one, and the same Bundle and target always give the same one, also after a detach and a new attach. It is opaque. - `created_at: string` Time the Bundle was attached. format: date-time - `slack_channel_id: string` The identifier of the Slack channel the Bundle is attached to, starting with `slch_`. It is the channel object's `id`, not Slack's `channel_id`. - `BetaClaudeTagSlackWorkspaceBundleTarget object` One Bundle attached to one Slack workspace. The Bundle can be used in the workspace and in every channel in it. - `type: "slack_workspace"` - `id: string` The Bundle Target's identifier. Starts with `btgt_`. No two Bundle Targets have the same one, and the same Bundle and target always give the same one, also after a detach and a new attach. It is opaque. - `created_at: string` Time the Bundle was attached. format: date-time - `slack_workspace_id: string` The identifier of the Slack workspace the Bundle is attached to, starting with `slws_`. #### Example ```bash curl https://api.anthropic.com/v1/organizations/claude_tag/bundles/$BUNDLE_ID/targets \ -H 'Content-Type: application/json' \ -H 'anthropic-version: 2026-10-21' \ -H 'anthropic-beta: experimental-claude-tag-2026-10-21' \ -H "Authorization: Bearer $ANTHROPIC_API_KEY" \ -d '{ "slack_channel_id": "xxxxxxxx", "type": "slack_channel" }' ``` ##### Response (200) ```json { "id": "id", "created_at": "2019-12-27T18:11:19.117Z", "slack_channel_id": "slack_channel_id", "type": "slack_channel" } ``` ### Get Bundle Target **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. #### Path parameters - `bundle_id: string` The Bundle's identifier, starting with `capp_`. - `target_id: string` The Bundle Target's identifier, starting with `btgt_`. Attach Bundle and List Bundle Targets return it. It is never the identifier of the channel or workspace. #### Headers - `"anthropic-version": optional string` The version of the Claude API you want to use. Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning?sdk_languages=http). - `"anthropic-beta": optional array of AnthropicBeta` This endpoint is in beta: requests must send `experimental-claude-tag-2026-10-21` in this header. - `string` - `"message-batches-2024-09-24"` - `"prompt-caching-2024-07-31"` - `"computer-use-2024-10-22"` - `"computer-use-2025-01-24"` - `"pdfs-2024-09-25"` - `"token-counting-2024-11-01"` - `"token-efficient-tools-2025-02-19"` - `"output-128k-2025-02-19"` - `"files-api-2025-04-14"` - `"mcp-client-2025-04-04"` - `"mcp-client-2025-11-20"` - `"dev-full-thinking-2025-05-14"` - `"interleaved-thinking-2025-05-14"` - `"code-execution-2025-05-22"` - `"extended-cache-ttl-2025-04-11"` - `"context-1m-2025-08-07"` - `"context-management-2025-06-27"` - `"model-context-window-exceeded-2025-08-26"` - `"skills-2025-10-02"` - `"fast-mode-2026-02-01"` - `"output-300k-2026-03-24"` - `"user-profiles-2026-03-24"` - `"user-profiles-2026-08-18"` - `"user-profiles-2026-09-04"` - `"advisor-tool-2026-03-01"` - `"managed-agents-2026-04-01"` - `"cache-diagnosis-2026-04-07"` - `"dreaming-2026-04-21"` - `"thinking-token-count-2026-05-13"` - `"server-side-fallback-2026-06-01"` - `"server-side-fallback-2026-07-01"` - `"fallback-credit-2026-06-01"` - `"fallback-credit-2026-07-01"` - `"agent-memory-2026-07-22"` - `"mid-conversation-tool-changes-2026-07-01"` - `"compact-2026-01-12"` - `"computer-use-2025-11-24"` - `"mcp-tunnels-2026-06-22"` - `"structured-outputs-2025-11-13"` - `"task-budgets-2026-03-13"` - `"thinking-display-updates-2026-08-18"` - `"ce-user-management-2026-07-13"` - `"mid-conversation-output-config-2026-07-01"` - `"thinking-binding-controls-2026-08-01"` - `"mid-conversation-system-clear-at-2026-08-21"` - `"compact-2026-09-04"` - `"inline-tools-2026-09-15"` - `"mcp-client-2026-09-15"` - `"ce-plugins-2026-09-01"` - `"spend-limit-reads-2026-09-26"` - `"telemetry-destinations-2026-08-11"` - `"webhooks-2026-10-07"` - `"message-threads-2026-08-12"` - `"analytics-usage-cost-2026-08-24"` - `"experimental-claude-tag-2026-10-21"` #### Returns - `BetaClaudeTagBundleTarget = BetaClaudeTagSlackChannelBundleTarget or BetaClaudeTagSlackWorkspaceBundleTarget` One Bundle attached to one Slack channel or one Slack workspace. More types of target can be added. - `BetaClaudeTagSlackChannelBundleTarget object` One Bundle attached to one Slack channel. The Bundle can be used in that channel only. - `type: "slack_channel"` - `id: string` The Bundle Target's identifier. Starts with `btgt_`. No two Bundle Targets have the same one, and the same Bundle and target always give the same one, also after a detach and a new attach. It is opaque. - `created_at: string` Time the Bundle was attached. format: date-time - `slack_channel_id: string` The identifier of the Slack channel the Bundle is attached to, starting with `slch_`. It is the channel object's `id`, not Slack's `channel_id`. - `BetaClaudeTagSlackWorkspaceBundleTarget object` One Bundle attached to one Slack workspace. The Bundle can be used in the workspace and in every channel in it. - `type: "slack_workspace"` - `id: string` The Bundle Target's identifier. Starts with `btgt_`. No two Bundle Targets have the same one, and the same Bundle and target always give the same one, also after a detach and a new attach. It is opaque. - `created_at: string` Time the Bundle was attached. format: date-time - `slack_workspace_id: string` The identifier of the Slack workspace the Bundle is attached to, starting with `slws_`. #### Example ```bash curl https://api.anthropic.com/v1/organizations/claude_tag/bundles/$BUNDLE_ID/targets/$TARGET_ID \ -H 'anthropic-version: 2026-10-21' \ -H 'anthropic-beta: experimental-claude-tag-2026-10-21' \ -H "Authorization: Bearer $ANTHROPIC_API_KEY" ``` ##### Response (200) ```json { "id": "id", "created_at": "2019-12-27T18:11:19.117Z", "slack_channel_id": "slack_channel_id", "type": "slack_channel" } ``` ### Detach Bundle **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. #### Path parameters - `bundle_id: string` The Bundle's identifier, starting with `capp_`. - `target_id: string` The Bundle Target's identifier, starting with `btgt_`. Attach Bundle and List Bundle Targets return it. It is never the identifier of the channel or workspace. #### Headers - `"anthropic-version": optional string` The version of the Claude API you want to use. Read more about versioning and our version history [here](https://platform.claude.com/docs/en/api/versioning?sdk_languages=http). - `"anthropic-beta": optional array of AnthropicBeta` This endpoint is in beta: requests must send `experimental-claude-tag-2026-10-21` in this header. - `string` - `"message-batches-2024-09-24"` - `"prompt-caching-2024-07-31"` - `"computer-use-2024-10-22"` - `"computer-use-2025-01-24"` - `"pdfs-2024-09-25"` - `"token-counting-2024-11-01"` - `"token-efficient-tools-2025-02-19"` - `"output-128k-2025-02-19"` - `"files-api-2025-04-14"` - `"mcp-client-2025-04-04"` - `"mcp-client-2025-11-20"` - `"dev-full-thinking-2025-05-14"` - `"interleaved-thinking-2025-05-14"` - `"code-execution-2025-05-22"` - `"extended-cache-ttl-2025-04-11"` - `"context-1m-2025-08-07"` - `"context-management-2025-06-27"` - `"model-context-window-exceeded-2025-08-26"` - `"skills-2025-10-02"` - `"fast-mode-2026-02-01"` - `"output-300k-2026-03-24"` - `"user-profiles-2026-03-24"` - `"user-profiles-2026-08-18"` - `"user-profiles-2026-09-04"` - `"advisor-tool-2026-03-01"` - `"managed-agents-2026-04-01"` - `"cache-diagnosis-2026-04-07"` - `"dreaming-2026-04-21"` - `"thinking-token-count-2026-05-13"` - `"server-side-fallback-2026-06-01"` - `"server-side-fallback-2026-07-01"` - `"fallback-credit-2026-06-01"` - `"fallback-credit-2026-07-01"` - `"agent-memory-2026-07-22"` - `"mid-conversation-tool-changes-2026-07-01"` - `"compact-2026-01-12"` - `"computer-use-2025-11-24"` - `"mcp-tunnels-2026-06-22"` - `"structured-outputs-2025-11-13"` - `"task-budgets-2026-03-13"` - `"thinking-display-updates-2026-08-18"` - `"ce-user-management-2026-07-13"` - `"mid-conversation-output-config-2026-07-01"` - `"thinking-binding-controls-2026-08-01"` - `"mid-conversation-system-clear-at-2026-08-21"` - `"compact-2026-09-04"` - `"inline-tools-2026-09-15"` - `"mcp-client-2026-09-15"` - `"ce-plugins-2026-09-01"` - `"spend-limit-reads-2026-09-26"` - `"telemetry-destinations-2026-08-11"` - `"webhooks-2026-10-07"` - `"message-threads-2026-08-12"` - `"analytics-usage-cost-2026-08-24"` - `"experimental-claude-tag-2026-10-21"` #### Returns - `BetaClaudeTagDeletedBundleTarget object` Confirms that a Bundle was detached. - `type: "bundle_target_deleted"` - `id: string` The identifier the Bundle Target had. #### Example ```bash curl https://api.anthropic.com/v1/organizations/claude_tag/bundles/$BUNDLE_ID/targets/$TARGET_ID \ -X DELETE \ -H 'anthropic-version: 2026-10-21' \ -H 'anthropic-beta: experimental-claude-tag-2026-10-21' \ -H "Authorization: Bearer $ANTHROPIC_API_KEY" ``` ##### Response (200) ```json { "id": "id", "type": "bundle_target_deleted" } ```