Claude Platform Docs
AmministrazioneOrganizzazione

API di Claude Tag

Gestisci Claude Tag in Slack per la tua organizzazione Claude Enterprise dai tuoi sistemi: leggi e modifica le impostazioni di canali e workspace Slack, scopri quali impostazioni si applicano e perché, e collega i pacchetti di accesso.

Claude Tag è Claude che lavora come un collega in Slack: qualcuno menziona Claude in un canale e Claude risponde nel thread. La Claude Tag API ti consente di leggere e modificare, dai tuoi sistemi, le impostazioni di Claude Tag che altrimenti un proprietario dell’organizzazione imposta manualmente in claude.ai > Impostazioni organizzazione > Claude Tag. Usala per attivare Claude canale per canale da un flusso di approvazione, mantenere la tua configurazione sotto controllo di versione o verificare cosa si applica in ogni canale.

Claude Tag è un prodotto di claude.ai. Questa API lo gestisce per un’organizzazione Claude Enterprise e non ha nulla a che fare con i workspace di Claude Platform, l’utilizzo dell’API o la Claude Console.

Endpoint

L’API espone 14 endpoint distribuiti su quattro risorse:

RisorsaEndpoint
Canali Slack: configura un canale, elenca i canali di un workspace o trovane uno tramite i suoi ID Slack, leggine uno, modificane le impostazioni, rimuoviloPOST /v1/organizations/claude_tag/slack_channels
GET /v1/organizations/claude_tag/slack_channels
GET /v1/organizations/claude_tag/slack_channels/{id}
POST /v1/organizations/claude_tag/slack_channels/{id}
DELETE /v1/organizations/claude_tag/slack_channels/{id}
Workspace Slack: elenca i tuoi workspace o trovane uno tramite il suo ID Slack, leggine uno, modificane le impostazioniGET /v1/organizations/claude_tag/slack_workspaces
GET /v1/organizations/claude_tag/slack_workspaces/{id}
POST /v1/organizations/claude_tag/slack_workspaces/{id}
Bundle: elenca i pacchetti di accesso della tua organizzazione, leggine uno (sola lettura)GET /v1/organizations/claude_tag/bundles
GET /v1/organizations/claude_tag/bundles/{bundle_id}
Target dei Bundle: elenca dove è collegato un Bundle, collegalo a un canale o workspace, leggi un collegamento, scollegaloGET /v1/organizations/claude_tag/bundles/{bundle_id}/targets
POST /v1/organizations/claude_tag/bundles/{bundle_id}/targets
GET /v1/organizations/claude_tag/bundles/{bundle_id}/targets/{target_id}
DELETE /v1/organizations/claude_tag/bundles/{bundle_id}/targets/{target_id}

Questa release copre Slack. La connessione e disconnessione di un workspace Slack o di un Enterprise Grid, le impostazioni predefinite Slack della tua organizzazione, la creazione e modifica dei pacchetti di accesso, i limiti di spesa e ogni impostazione di Claude Tag diversa dalle cinque in Impostazioni restano in claude.ai.

Prerequisiti

In Python, TypeScript, C#, Go, Java, PHP e Ruby, l’SDK espone questi endpoint sotto client.beta.organization.claude_tag, e la CLI ant sotto ant beta:organization:claude-tag; entrambi inviano per te gli header anthropic-version e anthropic-beta. Gli esempi in questa pagina leggono la chiave Admin API dalla variabile d’ambiente ANTHROPIC_API_KEY. Quando un SDK o la CLI recupera altre pagine per te, limit imposta la dimensione della pagina, non il totale (consulta Paginazione).

Le chiavi API appartengono all’organizzazione e continuano a funzionare anche dopo che la persona che le ha create se ne va. Non condividerle e non inserirle nel controllo del codice sorgente.

Avvio rapido

Elenca i workspace Slack della tua organizzazione in Claude Tag:

client = anthropic.Anthropic()

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

# Recupera automaticamente altre pagine secondo necessità.
for workspace in workspaces:
    print(f"{workspace.id}: {workspace.slack.workspace_id}")
Response
{
  "data": [
    {
      "type": "slack_workspace",
      "id": "slws_011CZkZnWa7xPc3uJfZe5LgT",
      "slack": {
        "workspace_id": "T01ABCD2EFG"
      },
      "settings": {
        "enabled": null,
        "instructions": "Answer in English unless asked otherwise.",
        "model": null,
        "environment_id": null,
        "guest_policy": null
      },
      "sources": {
        "enabled": null,
        "instructions": [
          {
            "type": "slack_workspace",
            "slack_workspace_id": "slws_011CZkZnWa7xPc3uJfZe5LgT"
          }
        ],
        "model": null,
        "environment_id": null,
        "guest_policy": null
      },
      "created_at": "2026-09-02T17:04:11Z",
      "updated_at": "2026-10-06T09:41:53Z"
    }
  ],
  "next_page": null
}

Un’impostazione che è null in settings non è impostata su questo workspace, quindi il workspace la eredita e non ha alcuna origine per essa. Per leggere invece ciò che si applica, consulta Valori memorizzati ed ereditati.

Scope

ScopeConcede
read:claude_tagOgni endpoint GET in questa pagina.
write:claude_tagOgni endpoint POST e DELETE in questa pagina. Non concede le letture, anche se la risposta a una modifica contiene la risorsa modificata.

Una chiave può avere entrambi gli ambiti. Un’integrazione che cerca un canale e poi lo modifica ha bisogno di entrambi. Nessun altro ambito concede l’accesso a questi endpoint, e una chiave creata nella Claude Console non funziona qui.

La chiave deve appartenere all’organizzazione nel suo insieme. L’organizzazione è sempre quella a cui appartiene la chiave, e nessuna richiesta ne indica una. L’header anthropic-workspace-id viene ignorato, perché nulla qui appartiene a un workspace di Claude Platform.

Concetti chiave

Nomi in questa pagina e in claude.ai

Questa APIclaude.ai e Slack
Workspace SlackUn workspace Slack. L’API di Slack lo chiama team, quindi l’ID del workspace di Slack in questa pagina corrisponde lì al team ID. Non ha alcuna relazione con un workspace di Claude Platform, i cui ID iniziano con wrkspc_.
Impostazioni predefinite SlackAccesso Slack predefinito: le impostazioni che si applicano a ogni workspace e canale. Un proprietario dell’organizzazione le modifica in claude.ai; questa API mostra dove un canale o un workspace le eredita.
Livello delle impostazioniUn ambito: un canale, un workspace o le impostazioni predefinite Slack
BundleUn pacchetto di accesso (glossario di Claude Tag)
enabledL’interruttore Enable Claude Tag in Slack
instructionsIstruzioni personalizzate
modelModello
environment_idAmbiente
guest_policyHow should Claude work in channels with guests: restrict corrisponde a Limita, channel_only a Solo canale e allow a Accesso completo

Canali e workspace configurati

Un canale o workspace è configurato (“set up”) quando Claude Tag conserva un record di impostazioni per esso. Solo un canale o workspace configurato ha un id, e solo questi vengono elencati: è Slack, non questa API, a conservare l’elenco completo dei canali di un workspace.

  • Un workspace viene configurato quando un proprietario dell’organizzazione lo connette in claude.ai. Quando un proprietario connette un Enterprise Grid di Slack, i workspace del Grid vengono configurati poco dopo. Il primo utilizzo di Claude in un workspace, o il primo canale che vi configuri, configura qualsiasi workspace che non lo fosse. Nessun altro endpoint configura un workspace, e nessuno ne rimuove uno.
  • Un canale viene configurato in claude.ai, dal primo utilizzo di Claude al suo interno, oppure con Configurare un canale.

La tua organizzazione possiede un workspace finché la sua connessione a quel workspace è attiva, e possiede i canali al suo interno. Un Enterprise Grid di Slack raggruppa diversi workspace sotto un’unica azienda. Finché la connessione della tua organizzazione a un Grid è attiva, essa possiede anche ogni workspace del Grid che nessun’altra organizzazione ha connesso. Un tale workspace è un workspace come qualsiasi altro: una volta configurato, ha un id, viene elencato e può essere letto, modificato e ricevere Bundle, e i suoi canali possono essere elencati. Il Grid stesso non è una risorsa di questa API e non ha un id. Un canale o un workspace che non possiedi restituisce lo stesso 404 di uno che non esiste.

Un workspace che la tua organizzazione possiede solo tramite un Grid restituisce quel 404 finché non viene configurato, ovunque una richiesta lo indichi tramite l’ID di Slack: quando cerchi il workspace, elenchi i suoi canali o cerchi al suo interno un canale non configurato. Puoi comunque configurare un canale al suo interno, il che configura anche il workspace, senza impostazioni memorizzate.

Un canale condiviso con un intero Grid può essere memorizzato sotto l’ID Slack del Grid stesso, che inizia con E, al posto di quello di un workspace. Quell’ID è quindi lo slack.workspace_id del canale, e elencare i canali con esso come slack_workspace_id restituisce quei canali. Nessun oggetto workspace lo possiede: se un proprietario ha memorizzato impostazioni sul Grid stesso in claude.ai, sources può indicarle come uno slack_workspace il cui id restituisce 404 quando lo leggi.

ID

Conosci un canale tramite gli ID che Slack ti mostra. Cerca il suo id una volta con Trovare un canale tramite i suoi ID Slack, poi memorizza e usa l’id.

IDPrefissoDove compare
Risorsa canale Slackslch_id su un canale; slack_channel_id nei corpi delle richieste e nelle risposte
Risorsa workspace Slackslws_id su un workspace; slack_workspace_id nei corpi delle richieste e nelle risposte
Bundlecapp_id su un Bundle; {bundle_id} nei percorsi
Target del Bundlebtgt_id su un target del Bundle; {target_id} nei percorsi
ID del workspace di SlackT, oppure E per l’ID del Grid stesso (consulta Canali e workspace configurati)slack.workspace_id; il parametro di query slack_workspace_id
ID del canale di SlackC o Gslack.channel_id; il parametro di query slack_channel_id

Un ID di canale Slack in un parametro di query o in un corpo della richiesta che non inizia con C o G restituisce 400, così come qualsiasi ID Slack che contenga qualcosa di diverso da lettere maiuscole e cifre dopo la prima lettera o che superi i 32 caratteri.

Un id non cambia finché il canale o il workspace è configurato, qualunque cosa tu modifichi su di esso, con un’eccezione descritta in Modalità di sola lettura. Un canale o un workspace che viene rimosso e configurato di nuovo ha un nuovo id, e quello vecchio continua a restituire 404. Quando un id memorizzato restituisce 404 senza error_code, elenca i tuoi workspace con la stessa chiave e gli stessi header. Quella richiesta non indica alcun canale o workspace, quindi se restituisce 200, l’id non esiste più: trova di nuovo il canale o il workspace tramite i suoi ID Slack. Qualsiasi altro stato non dice nulla sull’id: conserva i valori id memorizzati e consulta Risposte di errore.

Impostazioni

Ogni livello di impostazioni memorizza le stesse cinque impostazioni, tutte facoltative:

ImpostazioneTipoDescrizione
enabledbooleanSe Claude è attivo.
instructionsstringIndicazioni permanenti che Claude legge in ogni sessione. Al massimo 8.192 caratteri dopo la rimozione degli spazi iniziali e finali. Un testo vuoto cancella l’impostazione.
modelstringIl modello con cui iniziano le nuove sessioni: un ID di modello che la tua organizzazione può usare con Claude Tag. Al massimo 128 caratteri.
environment_idstringL’ambiente cloud in cui vengono eseguite le sessioni, con prefisso env_. Deve essere attivo e appartenere alla tua organizzazione.
guest_policyobjectCosa fa Claude in un canale mentre al suo interno è presente un ospite Slack, per tutti i membri del canale: {"type": "allow"} (Claude risponde), {"type": "restrict"} (Claude non risponde) o {"type": "channel_only"} (Claude risponde solo con i Bundle collegati al canale stesso; se channel_only non è disponibile per la tua organizzazione, una richiesta che lo imposta restituisce 400). Consulta Restrict guest channels per sapere cosa significa nei canali condivisi tramite Slack Connect o all’interno di un Enterprise Grid.

model e environment_id vengono verificati quando li scrivi e non più in seguito: se il modello o l’ambiente cambiano in seguito, le risposte continuano a restituire il valore memorizzato.

Se un proprietario dell’organizzazione ha assegnato un livello di impostazioni a un pool di runner self-hosted in claude.ai, il suo environment_id restituisce l’ID del pool, che inizia con ccpool_. Questa API non può impostare un pool di runner e restituisce 400 per una richiesta che modifica o cancella environment_id su un livello di impostazioni che ne memorizza uno.

Valori memorizzati ed ereditati

Le impostazioni esistono su tre livelli: il canale, il workspace in cui si trova il canale e le impostazioni predefinite Slack della tua organizzazione, che un proprietario dell’organizzazione imposta in claude.ai. Ogni livello memorizza solo ciò che è stato impostato su di esso. Il campo settings di un oggetto canale o workspace può contenere una delle due cose seguenti:

  • Ciò che memorizza. È ciò che una risposta contiene, a meno che tu non chieda diversamente. Un’impostazione non impostata sul canale o sul workspace è null. Usalo per confrontarlo con la configurazione che conservi altrove.
  • Cosa vi si applica, una volta considerato ogni livello. Per ottenerlo, aggiungi il parametro di query include_inherited=true a qualsiasi richiesta GET che restituisce un canale o un workspace, incluse le due liste. Usalo per eseguire un audit, o per scoprire perché Claude si comporta in un certo modo in un canale. Il valore predefinito del parametro è false, e un valore che non sia booleano restituisce 400. Una richiesta che configura un canale o modifica le impostazioni non accetta il parametro e restituisce 400 se lo invii; la sua risposta contiene ciò che è memorizzato.

In entrambi i casi sources indica, per ogni impostazione, il livello da cui proviene il valore in settings. Senza include_inherited, l’origine di un’impostazione memorizzata dal canale o dal workspace indica il canale o il workspace stesso, e un’impostazione che esso non memorizza non ha origine: null, o una lista vuota per instructions. Con include_inherited=true, ogni impostazione tranne instructions ha un’origine, e un’impostazione che nessun livello imposta ha l’origine {"type": "default"}; quando nessun livello imposta instructions, questa è null e la sua lista di origini è vuota. Quindi, per distinguere un valore che il canale o il workspace imposta da sé da uno che eredita, guarda la sua origine, non se il valore è null.

Ogni impostazione viene risolta separatamente:

ImpostazioneRegolaQuando nessun livello la imposta
enabledIl livello più vicino che la imposta determina il valore, quindi true su un canale attiva Claude in quel canale anche quando il suo workspace memorizza false.true
instructionsAdditiva. Il testo di ogni livello che la imposta viene unito, dal più ampio al più specifico, con una riga vuota tra l’uno e l’altro.null
modelIl livello più vicino che la imposta determina il valore.null: Claude usa il modello predefinito del prodotto
environment_idIl livello più vicino che la imposta determina il valore.null
guest_policyIl livello più vicino che la imposta determina il valore.restrict

Ad esempio, un’organizzazione memorizza istruzioni nelle sue impostazioni predefinite Slack, disattiva Claude su un workspace e imposta un modello su un canale di quel workspace. Letto con include_inherited=true, il canale mostra i tre valori e da dove proviene ciascuno:

{
  "type": "slack_channel",
  "id": "slch_011CZkZmRt4vNq8sHbYw2KdX",
  "slack": {
    "workspace_id": "T01ABCD2EFG",
    "channel_id": "C05HJKL6MNP"
  },
  "settings": {
    "enabled": false,
    "instructions": "Be brief.",
    "model": "claude-opus-5-5",
    "environment_id": null,
    "guest_policy": { "type": "restrict" }
  },
  "sources": {
    "enabled": {
      "type": "slack_workspace",
      "slack_workspace_id": "slws_011CZkZnWa7xPc3uJfZe5LgT"
    },
    "instructions": [{ "type": "slack_default" }],
    "model": {
      "type": "slack_channel",
      "slack_channel_id": "slch_011CZkZmRt4vNq8sHbYw2KdX"
    },
    "environment_id": { "type": "default" },
    "guest_policy": { "type": "default" }
  },
  "created_at": "2026-10-19T16:20:05Z",
  "updated_at": "2026-10-19T16:24:38Z"
}

Letto senza il parametro, lo stesso canale ha il suo model e quattro impostazioni null in settings; in sources, model indica il canale, instructions è una lista vuota e le altre tre sono null.

Una fonte è una delle seguenti:

typeSignificato
slack_channelIl canale, indicato in slack_channel_id.
slack_workspaceIl workspace, indicato in slack_workspace_id.
slack_parent_channelIl canale padre di un canale di codice, indicato in slack_channel_id. Un canale di codice è un canale avviato da un altro canale. Finché il padre è un canale pubblico nello stesso workspace, si colloca tra il canale e il workspace e contribuisce solo con instructions e environment_id.
slack_grid_channelLo stesso canale Slack configurato sotto un altro workspace del suo Enterprise Grid di Slack, indicato tramite gli ID di Slack sotto slack. Contribuisce solo con enabled: quando né il canale né il suo workspace impostano enabled, si applica un true memorizzato per il canale sotto un altro workspace del Grid.
slack_defaultLe impostazioni predefinite Slack della tua organizzazione, che non hanno ID.
defaultNessun livello imposta un valore, quindi si applica il valore predefinito integrato.

sources.instructions elenca ogni livello che contribuisce con del testo, dal più ampio al più specifico, che è l’ordine del loro testo in settings.instructions, ed è vuoto quando nessuno contribuisce. Indica il testo di chi viene prima, non dove finisce il testo di un livello: per ottenere il testo proprio di un livello, leggi quel canale o workspace senza include_inherited oppure, per le impostazioni predefinite Slack, controlla in claude.ai. Un’origine che indica un canale o un workspace ne riporta sempre l’ID, che non è mai null: un id di questa API in slack_channel_id o slack_workspace_id oppure, su slack_grid_channel, gli ID di Slack sotto slack come in un oggetto canale.

Con include_inherited=true, una richiesta fallisce con 503 se un livello non può essere letto, invece di rispondere senza di esso.

Modificare le impostazioni

I due endpoint di aggiornamento e Configurare un canale accettano un oggetto settings secondo le stesse regole:

  • Un’impostazione che ometti resta invariata. {"settings": {"enabled": false}} disattiva Claude e lascia le altre quattro impostazioni come sono.
  • Un’impostazione che invii come null viene cancellata, quindi il livello la eredita di nuovo.
  • Tutto o niente. Se un qualsiasi valore in una richiesta viene rifiutato, nessuna impostazione della richiesta viene memorizzata.
  • Sicura da ripetere. Ogni modifica lascia la risorsa come l’ha lasciata la prima richiesta identica, quindi nessun endpoint accetta un Idempotency-Key. Una richiesta che non altera nulla non scrive nulla e non registra alcun evento nell’Activity Feed.
  • Vince l’ultima scrittura. Nessuna richiesta accetta una precondizione. Due chiamanti che leggono ciascuno una risorsa e poi modificano la stessa impostazione si sovrascrivono a vicenda. Un 409 viene restituito solo quando un’altra modifica si sovrappone alla tua richiesta mentre è in esecuzione; nulla di ciò che la tua richiesta chiedeva di modificare o eliminare è stato fatto, tranne che una richiesta di configurazione potrebbe aver già configurato il canale, quindi leggi di nuovo la risorsa e invia di nuovo la modifica se è ancora necessaria.

Una modifica a guest_policy su un canale può terminare le sessioni in esecuzione in quel canale. Terminano in background e la risposta non attende che ciò avvenga.

Modalità di sola lettura

API / Terraform read-only mode è un’impostazione che un proprietario dell’organizzazione attiva e disattiva nelle impostazioni di Claude Tag di claude.ai. Il nome descrive claude.ai e Slack: mentre la modalità è attiva, questi rifiutano le modifiche di una persona a ciò che questa API gestisce, quindi solo le chiavi apportano quelle modifiche. Rifiutano anche alcune modifiche correlate che nessuna chiave apporta, come la modifica di un’impostazione nelle impostazioni predefinite Slack, quindi nessuno le apporta finché un proprietario non disattiva la modalità. Non rende questa API di sola lettura. Ogni endpoint in questa pagina risponde allo stesso modo che la modalità sia attiva o disattivata, e nessun endpoint la legge o la modifica.

Mentre la modalità è disattivata, persone e chiavi modificano le stesse impostazioni e collegano e scollegano gli stessi Bundle, e ogni modifica sostituisce ciò che è memorizzato. Attivala se la tua pipeline deve essere l’unica fonte di modifiche.

Mentre la modalità è attiva, claude.ai e Slack rifiutano:

  • Modificare una qualsiasi delle cinque impostazioni su un canale, un workspace o le impostazioni predefinite Slack (che nemmeno le chiavi modificano)
  • Configurare un canale, rimuovere un canale, aggiungere un workspace di un Enterprise Grid connesso, oppure disconnettere un workspace o un Grid in claude.ai
  • Collegare un Bundle a un canale o workspace, scollegarne uno, oppure eliminare un Bundle collegato a uno di essi

Alcune cose restano possibili in ogni caso: un proprietario può comunque connettere un nuovo workspace o Grid, creare e modificare Bundle e modificare le impostazioni di Claude Tag che questa API non gestisce. Il primo utilizzo di Claude configura comunque un canale, o un workspace del Grid non configurato, l’eliminazione di un canale in Slack lo rimuove comunque, e la disinstallazione dell’app Slack di Claude disconnette comunque quel workspace o Grid.

Mentre la modalità è disattivata, configurare in claude.ai un canale già configurato può sostituire il record del canale, ma solo per un canale che non contiene ancora nulla: uno configurato dal primo utilizzo di Claude, o configurato da questa API senza settings, e sul quale nessuno ha da allora memorizzato un’impostazione o collegato un Bundle. Il canale ha quindi un nuovo id, e quello vecchio restituisce 404. Qualsiasi altro canale mantiene il suo id finché non viene rimosso.

Messaggi diretti di gruppo

Un messaggio diretto di gruppo Slack ha un ID nel formato di un canale, quindi l’utilizzo di Claude in uno di essi lo configura come un canale: ha un id, viene elencato e può essere letto. Configurarne uno tramite questa API, modificarne un’impostazione, collegarvi un Bundle e rimuoverlo restituiscono ciascuno 400, tranne che una richiesta di configurazione che omette settings per uno già configurato lo restituisce con 200, come farebbe una lettura. Scollegarne un Bundle è consentito.

Flussi di lavoro di esempio

Attivare Claude solo nei canali approvati

Qualsiasi membro può invitare Claude in un canale pubblico. Per mantenere Claude attivo solo dove lo hai approvato:

  1. Chiedi a un proprietario dell’organizzazione di disattivare Claude ovunque in claude.ai, con l’interruttore Enable Claude Tag in Slack sotto Accesso Slack predefinito, che memorizza enabled come false nelle impostazioni predefinite Slack della tua organizzazione. La modalità di sola lettura deve essere disattivata mentre lo fa.
  2. Quando il tuo sistema di approvazione approva un canale, configura il canale con "settings": {"enabled": true}. La richiesta accetta gli ID di Slack e restituisce il canale anche se era già configurato, quindi è sicura da ripetere.
  3. Nella stessa esecuzione, collega i Bundle per cui il team è stato approvato, in modo che la prima sessione del canale disponga già dei suoi strumenti.

Mantenere la configurazione sotto controllo di versione

  1. Indicizza la tua configurazione con gli ID che Slack mostra per ogni canale e trova ogni canale tramite essi.
  2. Leggi ogni canale senza include_inherited e confronta il suo settings con ciò che il tuo repository dichiara. Con il parametro, verrebbero mescolati i valori ereditati.
  3. Invia solo le impostazioni che differiscono, e invia null per un’impostazione che il tuo repository non dichiara più.
  4. Chiedi a un proprietario dell’organizzazione di attivare la modalità di sola lettura, in modo che nessuno modifichi manualmente le stesse impostazioni.

Verificare cosa si applica ovunque

  1. Elenca i tuoi workspace, poi elenca i canali di ogni workspace, entrambi con include_inherited=true in modo che ogni elemento contenga ciò che si applica al suo interno. Se la tua organizzazione ha connesso un Enterprise Grid, elenca anche i canali memorizzati sotto l’ID Slack del Grid stesso. Consulta Canali e workspace configurati.
  2. Segnala ciò che la tua policy vieta, come un canale in cui enabled è true senza un’approvazione registrata, o in cui guest_policy è allow.
  3. Elenca i tuoi Bundle, poi i target di ogni Bundle, per vedere dove è collegato l’accesso ai sistemi sensibili.

Canali Slack

L’oggetto canale descrive un canale Slack:

CampoDescrizione
typeslack_channel.
idCon prefisso slch_. Consulta ID.
slackGli ID di Slack: workspace_id per il workspace in cui si trova il canale e channel_id per il canale.
settingsCiò che il canale stesso memorizza oppure, con include_inherited=true, ciò che si applica al suo interno. Sempre presente, con tutte e cinque le impostazioni; una che non è impostata è null. Consulta Valori memorizzati ed ereditati.
sourcesPer ogni impostazione, il livello da cui proviene il valore in settings. Sempre presente.
created_atQuando il canale è stato configurato.
updated_atQuando il record del canale in Claude Tag è cambiato l’ultima volta. Si aggiorna a ogni modifica di un’impostazione, qui, in claude.ai o in Slack, e può aggiornarsi anche per una modifica che nessuna risposta qui mostra. Considera un valore più recente come un motivo per leggere di nuovo il canale, non come prova che un’impostazione sia cambiata. Collegare o scollegare un Bundle non lo aggiorna di per sé.

Un id che non è un identificatore slch_ valido restituisce 400. Uno valido che non indica alcun canale della tua organizzazione restituisce 404.

Configurare un canale

POST /v1/organizations/claude_tag/slack_channels configura un canale Slack e lo restituisce. slack.workspace_id e slack.channel_id sono obbligatori e sono gli ID di Slack. settings è facoltativo e segue Modificare le impostazioni. Se il canale è già configurato, la richiesta restituisce il canale esistente e applica settings; la risposta è 200 in entrambi i casi. Richiede l’ambito write:claude_tag.

client = anthropic.Anthropic()

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

print(channel.id)
Response
{
  "type": "slack_channel",
  "id": "slch_011CZkZmRt4vNq8sHbYw2KdX",
  "slack": {
    "workspace_id": "T01ABCD2EFG",
    "channel_id": "C05HJKL6MNP"
  },
  "settings": {
    "enabled": null,
    "instructions": "Answer in the language of the question.",
    "model": null,
    "environment_id": null,
    "guest_policy": null
  },
  "sources": {
    "enabled": null,
    "instructions": [
      {
        "type": "slack_channel",
        "slack_channel_id": "slch_011CZkZmRt4vNq8sHbYw2KdX"
      }
    ],
    "model": null,
    "environment_id": null,
    "guest_policy": null
  },
  "created_at": "2026-10-19T16:20:05Z",
  "updated_at": "2026-10-19T16:20:05Z"
}

Prima che un canale venga configurato, l’app Slack di Claude verifica con Slack che il canale si trovi nel workspace, non sia archiviato e sia visibile all’app. Un canale che non supera quella verifica restituisce 404, così come un workspace in cui l’app Slack di Claude non è installata. Per un workspace che la tua organizzazione possiede tramite un Enterprise Grid, l’app deve essere installata sul Grid.

Configurare il canale e applicare settings sono due passaggi distinti. Quando questa richiesta configura il canale e settings viene poi rifiutato con un 400, 404 o 409, la risposta è il rifiuto e il canale resta configurato senza nulla di memorizzato (dopo un 409, a meno che la modifica sovrapposta non lo abbia rimosso o sostituito). Quel rifiuto riporta un error_code che inizia con slack_channel_set_up_ e l’id del nuovo canale in error.details.slack_channel_id (consulta Risposte di errore). Correggi settings e invialo in un aggiornamento a quell’id, oppure invia di nuovo la richiesta di configurazione. Se il canale era già configurato, un settings rifiutato restituisce lo stesso errore che restituirebbe un aggiornamento, e il canale mantiene ciò che aveva memorizzato. Un 500 o 503 in entrambi i casi non riporta alcun error_code e non indica se il canale è stato configurato o se settings è stato memorizzato: invia di nuovo la richiesta di configurazione.

Elencare i canali

GET /v1/organizations/claude_tag/slack_channels elenca i canali configurati di un workspace, dal più recente per created_at. slack_workspace_id è obbligatorio ed è l’ID di Slack del workspace. Aggiungi include_inherited=true per fare in modo che ogni canale contenga ciò che si applica al suo interno (consulta Valori memorizzati ed ereditati). Una pagina può contenere meno di limit canali, o nessuno, mentre next_page è ancora impostato, quindi continua a richiedere pagine finché next_page non è null (consulta Paginazione). Richiede l’ambito read:claude_tag.

client = anthropic.Anthropic()

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

# Recupera automaticamente altre pagine quando necessario.
for channel in channels:
    print(f"{channel.id}: {channel.slack.channel_id}")

La risposta è {"data": [...], "next_page": ...}, dove ogni elemento è un oggetto canale. Uno slack_workspace_id che indica un workspace non posseduto dalla tua organizzazione restituisce 404, e lo stesso vale per uno che essa possiede solo tramite un Enterprise Grid finché quel workspace non viene configurato (consulta Canali e workspace configurati).

Trovare un canale tramite i suoi ID Slack

Aggiungi slack_channel_id, l’ID di Slack del canale, per cercare un singolo canale. data contiene quel canale, oppure è vuoto quando il canale non è configurato. In un workspace non configurato che la tua organizzazione possiede solo tramite un Enterprise Grid, un canale non configurato restituisce invece 404. Una ricerca non viene paginata: ignora page e qualsiasi limit da 1 a 100 (un limit al di fuori di tale intervallo restituisce comunque 400), e il suo next_page è null. È così che trovi l’id di un canale.

client = anthropic.Anthropic()

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

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

Passare un ID slch_ come slack_channel_id restituisce 400.

Ottenere un canale

GET /v1/organizations/claude_tag/slack_channels/{id} restituisce l’oggetto canale, contenente ciò che il canale memorizza. Per leggere invece ciò che si applica al suo interno, consulta Leggere ciò che si applica in un canale. Richiede l’ambito read:claude_tag.

client = anthropic.Anthropic()

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

print(channel.settings.enabled)

Leggere ciò che si applica in un canale

La stessa richiesta con include_inherited=true restituisce l’oggetto canale con settings che contiene ciò che si applica nel canale, e sources che indica da dove proviene ogni valore. Valori memorizzati ed ereditati mostra una risposta completa; enabled e guest_policy non sono mai null al suo interno. Se un livello non può essere letto, la richiesta fallisce con 503 invece di rispondere senza di esso. Richiede l’ambito read:claude_tag.

client = anthropic.Anthropic()

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

print(channel.settings.instructions)

Aggiornare un canale

POST /v1/organizations/claude_tag/slack_channels/{id} modifica le impostazioni del canale e restituisce l’oggetto canale. settings è obbligatorio e segue Modificare le impostazioni. Richiede lo scope write:claude_tag.

Disattiva Claude in un canale e lascia le sue altre impostazioni come sono:

client = anthropic.Anthropic()

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

print(channel.settings.enabled)

Cancella le istruzioni del canale, in modo che si applichino solo quelle ereditate:

client = anthropic.Anthropic()

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

print(channel.settings.instructions)

Rimuovere un canale

DELETE /v1/organizations/claude_tag/slack_channels/{id} rimuove un canale da Claude Tag. È la stessa rimozione che un proprietario dell’organizzazione effettua in claude.ai, con lo stesso effetto. Non elimina, archivia né modifica il canale in Slack, né alcun messaggio al suo interno. Richiede lo scope write:claude_tag.

Un canale può essere rimosso solo mentre Claude è disattivato al suo interno. Finché enabled risulta true per il canale, come lo restituisce Leggere ciò che si applica in un canale, la richiesta restituisce 400 con error_code: "slack_channel_enabled". Imposta prima enabled su false sul canale, poi invia di nuovo la richiesta. L’unica eccezione è un’organizzazione con una configurazione di conformità restrittiva: non può apportare quella modifica, quindi la sua richiesta rimuove il canale indipendentemente dal fatto che Claude sia attivo al suo interno. Se un livello necessario per questa verifica non può essere letto, la richiesta restituisce 503 e non rimuove nulla.

La verifica protegge dalla rimozione per errore di un canale in uso. Non tiene Claude fuori dal canale in seguito. La rimozione elimina le impostazioni proprie del canale, incluso un enabled impostato su false, quindi da quel momento solo ciò che il canale eredita determina se Claude è attivo lì. Se questo attiva Claude, Claude risponde di nuovo nel canale alla sua successiva menzione, e quell’utilizzo configura il canale da capo: un nuovo id, nessuna impostazione propria e nulla della memoria del canale rimosso.

  • Per tenere Claude fuori da un canale, mantienilo configurato con enabled impostato su false invece di rimuoverlo, oppure assicurati che ciò che erediterebbe, che la rimozione non tocca, mantenga Claude disattivato.
  • Per fare in modo che un canale non memorizzi nulla e conservi le sue sessioni e la sua memoria, cancella invece ogni impostazione e scollega ogni Bundle.

Due tipi di canale non possono essere rimossi qui in alcun modo, che Claude sia attivo o disattivato al loro interno, e restituiscono 400 senza error_code: un messaggio diretto di gruppo e un canale che contiene una configurazione non gestita da questa API, come un pool di runner o un’impostazione presente solo in claude.ai. Questi vengono verificati prima di enabled, quindi disattivare Claude non aiuta; un proprietario dell’organizzazione rimuove il secondo tipo in claude.ai.

client = anthropic.Anthropic()

deleted_channel = client.beta.organization.claude_tag.slack_channels.delete(
    "slch_011CZkZmRt4vNq8sHbYw2KdX"
)

print(deleted_channel.id)
Response
{
  "type": "slack_channel_deleted",
  "id": "slch_011CZkZmRt4vNq8sHbYw2KdX"
}

L’id restituisce 404 non appena la richiesta termina, e il resto viene eliminato in background. Una rimozione ripetuta restituisce 404, quindi se invii di nuovo una rimozione dopo un 503, un 404 significa che il canale è già stato eliminato.

Workspace Slack

L’oggetto workspace descrive un workspace Slack. Ha gli stessi campi dell’oggetto canale, tranne che type è slack_workspace, id ha il prefisso slws_ e slack contiene solo workspace_id. La risposta della Guida rapida ne mostra uno completo. Letto con include_inherited=true, un workspace mostra ogni impostazione come risulta dal workspace e dalle impostazioni predefinite Slack, ovvero ciò che un canale del workspace eredita a meno che un livello più vicino non imposti quell’impostazione.

Un id che non è un identificatore slws_ valido restituisce 400. Uno valido che non indica alcun workspace della tua organizzazione restituisce 404.

Elencare i workspace

GET /v1/organizations/claude_tag/slack_workspaces elenca i workspace configurati posseduti dalla tua organizzazione, dal più recente per created_at. La Guida rapida mostra la richiesta e la risposta. Per trovare un workspace tramite l’ID di Slack, aggiungi slack_workspace_id: data contiene quel workspace, oppure è vuoto quando non è configurato, e un workspace non posseduto dalla tua organizzazione restituisce 404. Anche un workspace che essa possiede solo tramite un Enterprise Grid restituisce 404 finché non viene configurato. Aggiungi include_inherited=true per fare in modo che ogni workspace contenga ciò che si applica al suo interno (consulta Valori memorizzati ed ereditati). Richiede l’ambito read:claude_tag.

Ottenere un workspace

GET /v1/organizations/claude_tag/slack_workspaces/{id} restituisce l’oggetto workspace, contenente ciò che il workspace memorizza oppure, con include_inherited=true nella query come in Leggere ciò che si applica in un canale, ciò che si applica al suo interno. Richiede l’ambito read:claude_tag.

client = anthropic.Anthropic()

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

print(workspace.settings.instructions)

Aggiornare un workspace

POST /v1/organizations/claude_tag/slack_workspaces/{id} modifica le impostazioni del workspace e restituisce l’oggetto workspace. settings è obbligatorio e segue Modificare le impostazioni. Ciò che imposti qui si applica in ogni canale del workspace che non imposta un proprio valore, tranne instructions, a cui ogni canale aggiunge le proprie invece di sostituirle. Richiede l’ambito write:claude_tag.

client = anthropic.Anthropic()

workspace = client.beta.organization.claude_tag.slack_workspaces.update(
    "slws_011CZkZnWa7xPc3uJfZe5LgT",
    settings={"guest_policy": {"type": "restrict"}},
)

print(workspace.settings.guest_policy)

Bundle

Un Bundle è ciò che claude.ai chiama Pacchetto di accesso: un insieme denominato di accessi, come connettori, repository e credenziali, che Claude può utilizzare in un canale o in un workspace. I proprietari dell’organizzazione creano, modificano ed eliminano i Bundle in claude.ai. Questa API li elenca e li collega. Restituisce il nome e la descrizione di un Bundle e mai ciò che il Bundle concede.

CampoDescrizione
typebundle.
idCon prefisso capp_.
display_nameIl nome del Bundle.
descriptionA cosa serve il Bundle. null quando non ne ha una.
created_at, updated_atQuando il Bundle è stato creato e modificato l’ultima volta.

Un bundle_id che non è un identificatore capp_ valido restituisce 400. Uno valido che non esiste o appartiene a un’altra organizzazione restituisce 404, qualunque altra cosa contenga la richiesta. I Bundle che Claude Tag gestisce per sé non vengono elencati e restituiscono 404.

Elencare i Bundle

GET /v1/organizations/claude_tag/bundles elenca i Bundle della tua organizzazione, dal più recente per created_at. Richiede lo scope read:claude_tag.

client = anthropic.Anthropic()

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

# Recupera automaticamente altre pagine quando necessario.
for bundle in bundles:
    print(f"{bundle.id}: {bundle.display_name}")
Response
{
  "data": [
    {
      "type": "bundle",
      "id": "capp_011CZkZjLP1cWxj5EtMmdgbq",
      "display_name": "Support tools",
      "description": "Issue tracker and the support runbooks repository.",
      "created_at": "2026-09-12T08:15:30Z",
      "updated_at": "2026-09-30T13:02:47Z"
    }
  ],
  "next_page": null
}

Ottenere un Bundle

GET /v1/organizations/claude_tag/bundles/{bundle_id} restituisce l’oggetto Bundle. Richiede lo scope read:claude_tag.

client = anthropic.Anthropic()

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

print(bundle.display_name)

Target dei Bundle

Un target del Bundle è il record di un Bundle collegato a un canale o a un workspace. Un Bundle collegato a un workspace può essere utilizzato nel workspace e in ogni canale al suo interno. Un Bundle collegato a un canale può essere utilizzato solo in quel canale.

CampoDescrizione
typeslack_channel o slack_workspace.
idCon prefisso btgt_. È il {target_id} nei percorsi e non è mai l’id del canale o del workspace stesso.
slack_channel_idSu un target slack_channel: l’id del canale, con prefisso slch_.
slack_workspace_idSu un target slack_workspace: l’id del workspace, con prefisso slws_.
created_atQuando il Bundle è stato collegato.

Un Bundle viene collegato a un canale o a un workspace al massimo una volta, e la stessa coppia ha sempre lo stesso id, anche dopo uno scollegamento e un nuovo collegamento. L’id è opaco: ottienilo dalla risposta a un collegamento o dall’elenco. Un target del Bundle non contiene l’id del suo Bundle, che è necessario anche nei suoi percorsi, quindi conserva i due insieme.

Collegare o scollegare non modifica alcuna impostazione memorizzata. Le sessioni in esecuzione nel canale o nel workspace vengono informate che il suo accesso è cambiato.

Il Bundle che claude.ai collega come parte di una configurazione di reperibilità (on-call) viene elencato e può essere letto, ma non può essere collegato o scollegato qui, e nulla può essere collegato a un canale o workspace gestito da una configurazione di reperibilità, né scollegato da esso. Ciascuna di queste richieste restituisce 400.

Elencare i target di un Bundle

GET /v1/organizations/claude_tag/bundles/{bundle_id}/targets elenca i canali e i workspace a cui il Bundle è collegato, dal più recente per created_at. Richiede lo scope read:claude_tag.

client = anthropic.Anthropic()

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

# Recupera automaticamente altre pagine quando necessario.
for target in targets:
    print(f"{target.id}: {target.type}")
Response
{
  "data": [
    {
      "type": "slack_channel",
      "id": "btgt_011CZkZpBv9yQd6wKhAr8MnU1CZkZwPd5fSj8tMxUr3ZcH",
      "slack_channel_id": "slch_011CZkZmRt4vNq8sHbYw2KdX",
      "created_at": "2026-10-19T16:21:44Z"
    },
    {
      "type": "slack_workspace",
      "id": "btgt_011CZkZuMc3dVk7xQpGw9StZ1CZkZxRe6gTk9uNyVs4adJ",
      "slack_workspace_id": "slws_011CZkZnWa7xPc3uJfZe5LgT",
      "created_at": "2026-09-12T08:17:02Z"
    }
  ],
  "next_page": null
}

Vengono elencati solo i collegamenti a canali e workspace. Un Bundle collegato in claude.ai a qualcos’altro, come Accesso Slack predefinito, non ha un target del Bundle corrispondente, e lo stesso vale per una regola che applica un Bundle in molti canali contemporaneamente. Quindi i Bundle che Claude può utilizzare in un canale possono essere più dei target che lo nominano. Nessun endpoint elenca i Bundle collegati a un singolo canale o workspace.

Collegare un Bundle

POST /v1/organizations/claude_tag/bundles/{bundle_id}/targets collega il Bundle e restituisce il target del Bundle. Il corpo indica il type e l’id corrispondente. Il canale o il workspace deve essere già configurato: il collegamento non configura mai un canale. Collegare una coppia già collegata restituisce 200 con il target del Bundle esistente. Richiede lo scope write:claude_tag.

Collega un Bundle a un canale:

client = anthropic.Anthropic()

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

print(target.id)
Response
{
  "type": "slack_channel",
  "id": "btgt_011CZkZpBv9yQd6wKhAr8MnU1CZkZwPd5fSj8tMxUr3ZcH",
  "slack_channel_id": "slch_011CZkZmRt4vNq8sHbYw2KdX",
  "created_at": "2026-10-19T16:21:44Z"
}

Collega un Bundle a un workspace:

client = anthropic.Anthropic()

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

print(target.id)

Un collegamento a un canale ha delle condizioni in base alle quali si applica, ad esempio solo finché nel canale non è presente alcun ospite Slack. Le condizioni vengono impostate in claude.ai e non vengono restituite qui. Il collegamento tramite questa API utilizza le condizioni predefinite, e collegare una coppia già collegata lascia invariate le sue condizioni.

Ottenere un target del Bundle

GET /v1/organizations/claude_tag/bundles/{bundle_id}/targets/{target_id} restituisce il target del Bundle. Un target_id che non è un identificatore btgt_ valido restituisce 400. Uno valido che appartiene a un altro Bundle, è stato scollegato o indica un canale o un workspace non più configurato restituisce 404. Richiede l’ambito read:claude_tag.

client = anthropic.Anthropic()

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

print(target.type)

Scollegare un Bundle

DELETE /v1/organizations/claude_tag/bundles/{bundle_id}/targets/{target_id} scollega il Bundle. Uno scollegamento ripetuto restituisce 404, quindi dopo un 503, uno scollegamento inviato di nuovo che restituisce 404 significa che il target del Bundle è già stato eliminato. Richiede l’ambito write:claude_tag.

client = anthropic.Anthropic()

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

print(deleted_target.id)
Response
{
  "type": "bundle_target_deleted",
  "id": "btgt_011CZkZpBv9yQd6wKhAr8MnU1CZkZwPd5fSj8tMxUr3ZcH"
}

Valori non riconosciuti

guest_policy.type, il type di una fonte, il type di un Bundle target e i codici di errore possono acquisire nuovi valori in qualsiasi momento. Tratta un valore che non riconosci come faresti con qualsiasi stringa sconosciuta, anziché generare un errore.

Limitazione della velocità

Le richieste sono limitate per ogni organizzazione, in due budget condivisi da tutte le chiavi della tua organizzazione e separati dagli altri limiti dell’Admin API della tua organizzazione. Ogni budget consente una raffica e poi si ricarica a una velocità costante:

BudgetRichiesteRafficaRicarica
LettureOgni GET1202 al secondo
ModificheOgni POST e DELETE601 al secondo

Le richieste che superano un budget restituiscono 429 Too Many Requests con un header retry-after: attendi quel numero di secondi, poi invia di nuovo la richiesta. Una richiesta che è arrivata fino al suo budget, qualunque sia il suo esito, riceve gli header anthropic-ratelimit-requests-limit, anthropic-ratelimit-requests-remaining e anthropic-ratelimit-requests-reset per quel budget; una richiesta rifiutata prima, ad esempio per la sua chiave, il suo ambito o i suoi header, o perché l’API, le modifiche o il nuovo storage non sono abilitati per la tua organizzazione, non ne riceve nessuno.

Paginazione

Gli endpoint di elenco usano un cursore opaco. La prima richiesta restituisce fino a limit righe più un cursore next_page; passa il cursore invariato come parametro page nella richiesta successiva, con gli altri parametri di query invariati, e ripeti finché next_page non è null. Un cursore inviato con un valore di include_inherited diverso da quello della richiesta che lo ha restituito restituisce 400. Tratta la stringa del cursore come opaca: non analizzarla, modificarla o costruirla da te. Elencare i canali può restituire una pagina con meno di limit canali, o nessuno, mentre next_page è ancora impostato, quindi continua a richiedere pagine finché next_page non è null. Gli iteratori di elenco degli SDK Python, TypeScript, C#, Go, Java e Ruby e la CLI (tranne con --format raw) lo fanno per te. In PHP e curl, richiedi ogni pagina tu stesso e passa il suo next_page come page.

limit ha valore predefinito 20, con un minimo di 1 e un massimo di 100; un valore al di fuori di tale intervallo restituisce 400 su ogni elenco. Ogni elenco è ordinato dal più recente per created_at e non accetta altri ordinamenti.

Risposte di errore

Le risposte di errore seguono la struttura standard documentata in Errori della Claude API. Cita il request_id dal corpo della risposta quando contatti il supporto.

StatoSignificato
400Input non valido, oppure l’operazione non si applica a questo canale, workspace o Bundle (consulta la sezione di ciascun endpoint).
401Header x-api-key mancante, oppure la chiave non è riconosciuta.
403La chiave non è una chiave con ambito a livello di organizzazione, non ha l’ambito richiesto, oppure la tua organizzazione non può apportare questa modifica.
404Risorsa non trovata, o non appartenente alla tua organizzazione. Restituito anche quando la richiesta omette il valore anthropic-beta, o l’API non è abilitata per la tua organizzazione, in modo che gli endpoint risultino inesistenti.
409Qualcos’altro ha modificato o rimosso la risorsa mentre la richiesta era in esecuzione. Nulla di ciò che la richiesta chiedeva è stato fatto: nessuna impostazione memorizzata, nulla collegato, scollegato o rimosso. L’unica eccezione è una richiesta di configurazione, che può aver configurato il canale prima che il suo settings incontrasse il conflitto (slack_channel_set_up_settings_conflict). Leggi di nuovo la risorsa e invia di nuovo la richiesta se è ancora necessaria.
429“Rate limit” (limite di velocità) superato. Consulta Limitazione della velocità.
500Errore interno.
503Temporaneo. Su una modifica, non indica se la modifica è stata memorizzata. Ogni modifica è sicura da ripetere, quindi invia di nuovo la richiesta invariata. Se un DELETE inviato di nuovo restituisce poi 404, il canale o il target del Bundle è già stato eliminato.

Quando uno stato ha diverse cause che gestiresti in modo diverso, l’errore contiene anche error.details.error_code:

{
  "type": "error",
  "error": {
    "type": "invalid_request_error",
    "message": "...",
    "details": {
      "error_code": "slack_channel_set_up_settings_refused",
      "slack_channel_id": "slch_011CZkZmRt4vNq8sHbYw2KdX"
    }
  },
  "request_id": "req_018EeWyXxfu5pfWkrYcMdjWG"
}
error_codeStatoSignificato e cosa fare
organization_level_scoped_api_key_required403La credenziale non è una chiave Admin API con ambito che appartiene all’organizzazione nel suo insieme. Chiedine una al tuo proprietario principale.
api_key_scope_missing403La chiave non ha read:claude_tag o write:claude_tag, a seconda di quale richiede l’endpoint.
claude_tag_writes_not_enabled403La tua organizzazione può leggere tramite questa API ma non è abilitata alle modifiche.
compliance_configuration_restricted403La tua organizzazione ha una configurazione di conformità in base alla quale Claude Tag non memorizza nulla di nuovo, come la conservazione zero dei dati. La configurazione di un canale, l’aggiornamento delle impostazioni (anche per cancellarle) e il collegamento di un Bundle vengono rifiutati. Lo scollegamento di un Bundle e la rimozione di un canale no, e un’organizzazione di questo tipo può rimuovere un canale anche mentre Claude è attivo al suo interno.
environment_not_found404environment_id non indica alcun ambiente che la tua organizzazione può usare qui. L’id nel percorso è corretto.
environment_archived400environment_id indica un ambiente archiviato.
slack_channel_set_up_settings_refused400La richiesta ha configurato il canale, poi settings è stato rifiutato. details.slack_channel_id è il canale. Consulta Configurare un canale.
slack_channel_set_up_environment_not_found404La richiesta ha configurato il canale, poi environment_id non è stato trovato. details.slack_channel_id è il canale. Consulta Configurare un canale.
slack_channel_set_up_settings_conflict409La richiesta ha configurato il canale, poi un’altra modifica si è sovrapposta a settings. Nulla di settings è stato memorizzato. details.slack_channel_id è il canale. Consulta Configurare un canale.
slack_channel_enabled400Claude è attivo nel canale (enabled risulta true), quindi non può essere rimosso. Imposta prima enabled su false. Consulta Rimuovere un canale.

Potrebbero essere aggiunti nuovi codici. Tratta un codice che non riconosci come tratti il suo stato. Un 404 senza error_code ha una di due cause. O qualcosa indicato dalla richiesta non è stato trovato (un id nel percorso, o un canale o workspace Slack nel corpo o nella query), oppure ogni endpoint risulta inesistente perché la richiesta omette il valore anthropic-beta o l’API non è abilitata per la tua organizzazione. Per distinguerli, elenca i tuoi workspace con la stessa chiave e gli stessi header: quella richiesta non indica nulla, quindi restituisce 404 solo nel secondo caso.

Eventi dell’Activity Feed

Ogni modifica effettuata tramite questa API viene registrata nell’Activity Feed della Compliance API della tua organizzazione, attribuita alla chiave API come api_actor con il relativo ID apikey_. Gli eventi sono gli stessi che il feed registra quando la stessa modifica viene effettuata in claude.ai, quindi un’unica query trova una modifica indipendentemente dal modo in cui è stata effettuata.

EventoEmesso quando
ccr_agent_createdUn canale viene configurato.
ccr_agent_updatedUn’impostazione cambia su un canale o su un workspace.
ccr_agent_deletedUn canale viene rimosso. I suoi target dei Bundle vengono rimossi con esso e non emettono alcun evento proprio.
ccr_agent_proxy_profile_boundUn Bundle viene collegato.
ccr_agent_proxy_profile_unboundUn Bundle viene scollegato.

Gli eventi indicano un canale o un workspace tramite un identificatore proprio del feed, agent_id (con prefisso cagt_), che nessuna risposta di questa API contiene, quindi non puoi ancora associare un evento all’id di un canale o di un workspace. I due eventi dei Bundle indicano il Bundle in profile_id e il canale o workspace, tramite lo stesso agent_id, in scope_id.

Un evento ccr_agent_updated elenca ciò che è cambiato in updated_fields, con i nomi propri del feed:

ImpostazioneNome in updated_fields
enabledslackbot_version
instructionssystem_prompt_addendum
modeldefault_model
environment_iddefault_environment_id
guest_policyguest_policy

updated_fields può contenere anche is_virtual, che non indica alcuna impostazione. Compare accanto ai nomi delle impostazioni modificate nell’evento relativo a una modifica tramite questa API che è la prima cosa che qualcuno memorizza sul canale o sul workspace: un canale configurato dal primo utilizzo di Claude, o configurato da questa API senza settings, o un workspace in cui Claude non è mai stato usato, e sul quale nessuno ha ancora memorizzato un’impostazione o collegato un Bundle, qui o in claude.ai. Il model con cui inizia un canale di codice non conta come memorizzato. Il collegamento di un Bundle registra solo ccr_agent_proxy_profile_bound.

Le letture, le richieste che non modificano nulla e le richieste rifiutate prima che venga memorizzato qualcosa non registrano nulla. Una richiesta di configurazione che configura un canale e il cui settings viene poi rifiutato registra ccr_agent_created.

Vedi anche

Dove il tuo proprietario principale crea una chiave con scope definito.

Cos’è Claude Tag, come configurarlo e cosa fa ciascuna impostazione in Slack.

La traccia di controllo di ogni modifica effettuata qui e in claude.ai.

Gestisci i plugin nella tua organizzazione Claude Enterprise.

Questa pagina ti è stata utile?