Claude Platform Docs

Organizzazione

Ottieni l'organizzazione corrente
GET/v1/organizations/me

Recupera le informazioni sull'organizzazione associata alla chiave API autenticata.

Models
ConcurrentMembershipChangeErrorDetails object{ error_code }

Another change to the organization's members is in progress. Retry the request once it completes.

error_code: "concurrent_membership_change"
OrgMemberLimitExceededErrorDetails object{ error_code }

The organization has reached the member limit that Anthropic set for it. Pending invites count toward the limit.

error_code: "org_member_limit_exceeded"
OrganizationInfo object{ type: "organization", id, name }
type: "organization"

Object type.

For Organizations, this is always "organization".

defaultorganization
id: string

ID of the Organization.

formatuuid
name: string

Name of the Organization.

OrganizationRole = "admin" or "billing" or "claude_code_user" or 6 more
One of the following:
"admin"
"billing"
"claude_code_user"
"developer"
"managed"
"membership_admin"
"owner"
"primary_owner"
"user"
RBACRoleNotFoundErrorDetails object{ error_code }

No RBAC Role with this ID was found.

error_code: "rbac_role_not_found"

OrganizzazioneChiavi API

Elenca le chiavi API
GET/v1/organizations/api_keys
Recupera chiave API (Admin API)
GET/v1/organizations/api_keys/{api_key_id}

Recupera le informazioni su una singola chiave API della tua organizzazione, cercata tramite il suo ID. Questo endpoint dell'Admin API richiede una chiave Admin API, è pensato per la gestione programmatica delle chiavi e non restituisce mai il valore segreto della chiave. Per visualizzare o creare le tue chiavi API, vai su Chiavi API nella Claude Console.

Aggiorna chiave API
POST/v1/organizations/api_keys/{api_key_id}

OrganizzazioneChiavi esterne

Crea chiave esterna
POST/v1/organizations/external_keys

Crea una configurazione di chiave esterna di proprietà dell'organizzazione del chiamante.

Elenca le chiavi esterne
GET/v1/organizations/external_keys

Elenca le configurazioni di chiavi esterne nell'organizzazione del chiamante.

Ottieni chiave esterna
GET/v1/organizations/external_keys/{external_key_id}

Recupera una singola configurazione di chiave esterna nell'organizzazione del chiamante tramite ID.

Aggiorna chiave esterna
POST/v1/organizations/external_keys/{external_key_id}

Aggiorna parzialmente una configurazione di chiave esterna. I campi omessi restano invariati.

Elimina chiave esterna
DELETE/v1/organizations/external_keys/{external_key_id}

Elimina una configurazione di chiave esterna.

Convalida chiave esterna
POST/v1/organizations/external_keys/{external_key_id}/validate

Convalida una configurazione di chiave esterna rispetto al KMS del cliente.

OrganizzazioneFederazioneEmittenti

Crea emittente di federazione
POST/v1/organizations/federation_issuers

Richiede un token di accesso OAuth con lo scope org:admin, ottenuto da ant auth login --scope org:admin o da una regola di workload identity federation; le chiavi Admin API non sono accettate. Consulta Gestire WIF con l'Admin API.

Elenca gli emittenti di federazione
GET/v1/organizations/federation_issuers

Richiede un token di accesso OAuth con lo scope org:admin, ottenuto da ant auth login --scope org:admin o da una regola di workload identity federation; le chiavi Admin API non sono accettate. Consulta Gestire WIF con l'Admin API.

Ottieni emittente di federazione
GET/v1/organizations/federation_issuers/{federation_issuer_id}

Richiede un token di accesso OAuth con lo scope org:admin, ottenuto da ant auth login --scope org:admin o da una regola di workload identity federation; le chiavi Admin API non sono accettate. Consulta Gestire WIF con l'Admin API.

Aggiorna emittente di federazione
POST/v1/organizations/federation_issuers/{federation_issuer_id}

Richiede un token di accesso OAuth con lo scope org:admin, ottenuto da ant auth login --scope org:admin o da una regola di workload identity federation; le chiavi Admin API non sono accettate. Consulta Gestire WIF con l'Admin API.

Archivia emittente di federazione
POST/v1/organizations/federation_issuers/{federation_issuer_id}/archive

Richiede un token di accesso OAuth con lo scope org:admin, ottenuto da ant auth login --scope org:admin o da una regola di workload identity federation; le chiavi Admin API non sono accettate. Consulta Gestire WIF con l'Admin API.

OrganizzazioneFederazioneRegole

Crea regola di federazione
POST/v1/organizations/federation_rules

Richiede un token di accesso OAuth con lo scope org:admin, ottenuto da ant auth login --scope org:admin o da una regola di workload identity federation; le chiavi Admin API non sono accettate. Consulta Gestire WIF con l'Admin API.

Elenca le regole di federazione
GET/v1/organizations/federation_rules

Richiede un token di accesso OAuth con lo scope org:admin, ottenuto da ant auth login --scope org:admin o da una regola di workload identity federation; le chiavi Admin API non sono accettate. Consulta Gestire WIF con l'Admin API.

Ottieni regola di federazione
GET/v1/organizations/federation_rules/{federation_rule_id}

Richiede un token di accesso OAuth con lo scope org:admin, ottenuto da ant auth login --scope org:admin o da una regola di workload identity federation; le chiavi Admin API non sono accettate. Consulta Gestire WIF con l'Admin API.

Aggiorna regola di federazione
POST/v1/organizations/federation_rules/{federation_rule_id}

Richiede un token di accesso OAuth con lo scope org:admin, ottenuto da ant auth login --scope org:admin o da una regola di workload identity federation; le chiavi Admin API non sono accettate. Consulta Gestire WIF con l'Admin API.

Archivia regola di federazione
POST/v1/organizations/federation_rules/{federation_rule_id}/archive

Richiede un token di accesso OAuth con lo scope org:admin, ottenuto da ant auth login --scope org:admin o da una regola di workload identity federation; le chiavi Admin API non sono accettate. Consulta Gestire WIF con l'Admin API.

OrganizzazioneFederazioneRegoleWorkspace

Aggiungi workspace alla regola di federazione
POST/v1/organizations/federation_rules/{federation_rule_id}/workspaces

Richiede un token di accesso OAuth con lo scope org:admin, ottenuto da ant auth login --scope org:admin o da una regola di workload identity federation; le chiavi Admin API non sono accettate. Consulta Gestire WIF con l'Admin API.

Elenca i workspace della regola di federazione
GET/v1/organizations/federation_rules/{federation_rule_id}/workspaces

Richiede un token di accesso OAuth con lo scope org:admin, ottenuto da ant auth login --scope org:admin o da una regola di workload identity federation; le chiavi Admin API non sono accettate. Consulta Gestire WIF con l'Admin API.

Rimuovi workspace dalla regola di federazione
DELETE/v1/organizations/federation_rules/{federation_rule_id}/workspaces/{workspace_id}

Richiede un token di accesso OAuth con lo scope org:admin, ottenuto da ant auth login --scope org:admin o da una regola di workload identity federation; le chiavi Admin API non sono accettate. Consulta Gestire WIF con l'Admin API.

OrganizzazioneInviti

Crea invito
POST/v1/organizations/invites

Invita un utente a unirsi all'organizzazione tramite email.

Elenca gli inviti
GET/v1/organizations/invites

Elenca gli inviti dell'organizzazione.

Ottieni invito
GET/v1/organizations/invites/{invite_id}

Recupera un invito tramite ID.

Elimina invito
DELETE/v1/organizations/invites/{invite_id}

Elimina un invito in sospeso.

OrganizzazioneAccount di servizio

Crea account di servizio
POST/v1/organizations/service_accounts

Richiede un token di accesso OAuth con lo scope org:admin, ottenuto da ant auth login --scope org:admin o da una regola di workload identity federation; le chiavi Admin API non sono accettate. Consulta Gestire WIF con l'Admin API.

Elenca gli account di servizio
GET/v1/organizations/service_accounts

Richiede un token di accesso OAuth con lo scope org:admin, ottenuto da ant auth login --scope org:admin o da una regola di workload identity federation; le chiavi Admin API non sono accettate. Consulta Gestire WIF con l'Admin API.

Ottieni account di servizio
GET/v1/organizations/service_accounts/{service_account_id}

Richiede un token di accesso OAuth con lo scope org:admin, ottenuto da ant auth login --scope org:admin o da una regola di workload identity federation; le chiavi Admin API non sono accettate. Consulta Gestire WIF con l'Admin API.

Aggiorna account di servizio
POST/v1/organizations/service_accounts/{service_account_id}

Richiede un token di accesso OAuth con lo scope org:admin, ottenuto da ant auth login --scope org:admin o da una regola di workload identity federation; le chiavi Admin API non sono accettate. Consulta Gestire WIF con l'Admin API.

Archivia account di servizio
POST/v1/organizations/service_accounts/{service_account_id}/archive

Richiede un token di accesso OAuth con lo scope org:admin, ottenuto da ant auth login --scope org:admin o da una regola di workload identity federation; le chiavi Admin API non sono accettate. Consulta Gestire WIF con l'Admin API.

OrganizzazioneAccount di servizioWorkspace

Aggiungi workspace all'account di servizio
POST/v1/organizations/service_accounts/{service_account_id}/workspaces

Richiede un token di accesso OAuth con lo scope org:admin, ottenuto da ant auth login --scope org:admin o da una regola di workload identity federation; le chiavi Admin API non sono accettate. Consulta Gestire WIF con l'Admin API.

Elenca i workspace dell'account di servizio
GET/v1/organizations/service_accounts/{service_account_id}/workspaces

Richiede un token di accesso OAuth con lo scope org:admin, ottenuto da ant auth login --scope org:admin o da una regola di workload identity federation; le chiavi Admin API non sono accettate. Consulta Gestire WIF con l'Admin API.

Rimuovi workspace dall'account di servizio
DELETE/v1/organizations/service_accounts/{service_account_id}/workspaces/{workspace_id}

Richiede un token di accesso OAuth con lo scope org:admin, ottenuto da ant auth login --scope org:admin o da una regola di workload identity federation; le chiavi Admin API non sono accettate. Consulta Gestire WIF con l'Admin API.

OrganizzazioneUtenti

Elenca gli utenti
GET/v1/organizations/users

Elenca i membri dell'organizzazione.

Ottieni utente
GET/v1/organizations/users/{user_id}

Recupera un membro dell'organizzazione tramite ID utente.

Aggiorna utente
POST/v1/organizations/users/{user_id}

Aggiorna il ruolo di un membro nell'organizzazione.

Rimuovi utente
DELETE/v1/organizations/users/{user_id}

Rimuovi un membro dall'organizzazione.

OrganizzazioneWorkspace

Elenca i workspace
GET/v1/organizations/workspaces
Crea workspace
POST/v1/organizations/workspaces
Ottieni workspace
GET/v1/organizations/workspaces/{workspace_id}
Aggiorna workspace
POST/v1/organizations/workspaces/{workspace_id}
Archivia workspace
POST/v1/organizations/workspaces/{workspace_id}/archive

OrganizzazioneWorkspaceLimiti di velocità

Elenca i limiti di velocità del workspace
GET/v1/organizations/workspaces/{workspace_id}/rate_limits

Elenca i "rate limit" (limiti di velocità) di un workspace.

Imposta i limiti di velocità del workspace
POST/v1/organizations/workspaces/{workspace_id}/rate_limits/{rate_limit_id}

Imposta o rimuovi gli override dei limiti di velocità per un gruppo di limiti di velocità in un workspace.

OrganizzazioneWorkspaceMembri

Elenca i membri del workspace
GET/v1/organizations/workspaces/{workspace_id}/members
Crea membro del workspace
POST/v1/organizations/workspaces/{workspace_id}/members
Ottieni membro del workspace
GET/v1/organizations/workspaces/{workspace_id}/members/{user_id}
Aggiorna membro del workspace
POST/v1/organizations/workspaces/{workspace_id}/members/{user_id}
Elimina membro del workspace
DELETE/v1/organizations/workspaces/{workspace_id}/members/{user_id}

OrganizzazioneWorkspaceAccount di servizio

Elenca gli account di servizio membri del workspace
GET/v1/organizations/workspaces/{workspace_id}/service_accounts

Richiede un token di accesso OAuth con lo scope org:admin, ottenuto da ant auth login --scope org:admin o da una regola di workload identity federation; le chiavi Admin API non sono accettate. Consulta Gestire WIF con l'Admin API.

Crea account di servizio membro del workspace
POST/v1/organizations/workspaces/{workspace_id}/service_accounts

Richiede un token di accesso OAuth con lo scope org:admin, ottenuto da ant auth login --scope org:admin o da una regola di workload identity federation; le chiavi API Admin non sono accettate. Consulta Gestire WIF con l'Admin API.

Ottieni account di servizio membro del workspace
GET/v1/organizations/workspaces/{workspace_id}/service_accounts/{service_account_id}

Richiede un token di accesso OAuth con lo scope org:admin, ottenuto da ant auth login --scope org:admin o da una regola di workload identity federation; le chiavi API Admin non sono accettate. Consulta Gestire WIF con l'Admin API.

Aggiorna account di servizio membro del workspace
POST/v1/organizations/workspaces/{workspace_id}/service_accounts/{service_account_id}

Richiede un token di accesso OAuth con lo scope org:admin, ottenuto da ant auth login --scope org:admin o da una regola di workload identity federation; le chiavi API Admin non sono accettate. Consulta Gestire WIF con l'Admin API.

Elimina account di servizio membro del workspace
DELETE/v1/organizations/workspaces/{workspace_id}/service_accounts/{service_account_id}

Richiede un token di accesso OAuth con lo scope org:admin, ottenuto da ant auth login --scope org:admin o da una regola di workload identity federation; le chiavi API Admin non sono accettate. Consulta Gestire WIF con l'Admin API.

OrganizzazioneLimiti di velocità

Elenca i limiti di velocità dell'organizzazione
GET/v1/organizations/rate_limits

Elenca i "rate limit" (limiti di velocità) della Messages API per la tua organizzazione.

OrganizzazioneImpostazioni di conformità

Ottieni le impostazioni di conformità
GET/v1/organizations/compliance_settings

Recupera le impostazioni di conformità (Compliance Settings) della tua organizzazione.

Aggiorna le impostazioni di conformità
POST/v1/organizations/compliance_settings

Aggiorna le impostazioni di conformità (Compliance Settings) della tua organizzazione.

OrganizzazioneAnalisiRiepiloghi

Ottieni riepiloghi delle attività
GET/v1/organizations/analytics/summaries

Ottieni i riepiloghi delle attività a livello di organizzazione per un intervallo di date.

OrganizzazioneAnalisiUtenti

Elenca attività utente
GET/v1/organizations/analytics/users

Ottieni l'attività per utente per un determinato giorno, con paginazione basata su cursore.

OrganizzazioneAnalisiAppChatProgetti

Ottieni utilizzo dei progetti di chat
GET/v1/organizations/analytics/apps/chat/projects

Ottieni l'attività per progetto per un determinato giorno, con paginazione basata su cursore.

OrganizzazioneAnalisiConnettori

Ottieni utilizzo dei connettori
GET/v1/organizations/analytics/connectors

Ottieni l'utilizzo per connettore per un determinato giorno, con paginazione basata su cursore.

OrganizzazioneAnalisiPlugin

Ottieni utilizzo dei plugin
GET/v1/organizations/analytics/plugins

Ottieni l'utilizzo di installazione + invocazione per plugin per un determinato giorno, con paginazione.

OrganizzazioneAnalisiSkill

Ottieni utilizzo delle skill
GET/v1/organizations/analytics/skills

Ottieni l'utilizzo per skill per un determinato giorno, con paginazione basata su cursore.

OrganizzazioneAnalisiArtifacts

Ottieni attività degli artifact
GET/v1/organizations/analytics/artifacts

Ottieni l'attività di creazione di artifact per un determinato giorno, suddivisa per tipo MIME.

OrganizzazioneLimiti di spesaEffettivi

Elenca limiti di spesa effettivi
GET/v1/organizations/spend_limits/effective

Elenca il limite di spesa effettivo e la spesa dall'inizio del periodo di ciascun membro.

OrganizzazioneLimiti di spesaRichieste di aumento

Elenca richieste di aumento del limite di spesa
GET/v1/organizations/spend_limit_increase_requests

Elenca le richieste di aumento del limite di spesa, dalla più recente.

Ottieni richiesta di aumento del limite di spesa
GET/v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}

Recupera una richiesta di aumento del limite di spesa.

Approva richiesta di aumento del limite di spesa
POST/v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}/approve

Approva una richiesta di aumento del limite di spesa in sospeso.

Rifiuta richiesta di aumento del limite di spesa
POST/v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}/deny

Rifiuta una richiesta di aumento del limite di spesa in sospeso.

OrganizzazioneGruppi RBAC

Crea gruppo RBAC
POST/v1/organizations/rbac_groups

Crea un gruppo RBAC nel tenant Claude Enterprise. I gruppi creati tramite l'API hanno tipo di origine "direct".

Elenca gruppi RBAC
GET/v1/organizations/rbac_groups

Elenca i gruppi RBAC nel tenant Claude Enterprise.

Ottieni gruppo RBAC
GET/v1/organizations/rbac_groups/{rbac_group_id}

Recupera un gruppo RBAC tramite ID.

Aggiorna gruppo RBAC
POST/v1/organizations/rbac_groups/{rbac_group_id}

Aggiorna il nome di un gruppo RBAC. I gruppi forniti da un provider di identità (tipo di origine "scim") non possono essere modificati tramite l'API mentre un'organizzazione nel tenant usa il provisioning SCIM.

Elimina gruppo RBAC
DELETE/v1/organizations/rbac_groups/{rbac_group_id}

Elimina un gruppo RBAC. I gruppi forniti da un provider di identità (tipo di origine "scim") non possono essere eliminati tramite l'API mentre un'organizzazione nel tenant usa il provisioning SCIM.

OrganizzazioneGruppi RBACMembri

Elenca membri del gruppo RBAC
GET/v1/organizations/rbac_groups/{rbac_group_id}/members

Elenca i membri di un gruppo RBAC.

Aggiungi membro al gruppo RBAC
POST/v1/organizations/rbac_groups/{rbac_group_id}/members

Aggiunge un utente a un gruppo RBAC. L'appartenenza ai gruppi forniti da un provider di identità (tipo di origine "scim") non può essere modificata tramite l'API mentre un'organizzazione nel tenant usa il provisioning SCIM.

Rimuovi membro dal gruppo RBAC
DELETE/v1/organizations/rbac_groups/{rbac_group_id}/members/{user_id}

Rimuove un utente da un gruppo RBAC. L'appartenenza ai gruppi forniti da un provider di identità (tipo di origine "scim") non può essere modificata tramite l'API mentre un'organizzazione nel tenant usa il provisioning SCIM.

OrganizzazioneRuoli RBAC

Elenca ruoli RBAC
GET/v1/organizations/rbac_roles

Elenca i ruoli RBAC nell'organizzazione.

Ottieni ruolo RBAC
GET/v1/organizations/rbac_roles/{rbac_role_id}

Recupera un ruolo RBAC tramite ID.

OrganizzazioneRuoli RBACAutorizzazioni

Elenca autorizzazioni del ruolo RBAC
GET/v1/organizations/rbac_roles/{rbac_role_id}/permissions

Elenca le autorizzazioni concesse da un ruolo RBAC.