Claude Platform Docs

Beta

Models
type AnthropicBeta = Union[str, Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 47 more]]
One of the following:
class BetaAPIError: type: "api_error"; message
type: Literal["api_error"]
defaultapi_error
message: str
defaultInternal server error
class BetaAuthenticationError: type: "authentication_error"; message
type: Literal["authentication_error"]
defaultauthentication_error
message: str
defaultAuthentication error
class BetaBillingError: type: "billing_error"; message
type: Literal["billing_error"]
defaultbilling_error
message: str
defaultBilling error
type BetaCurrency = Literal["USD"]
type BetaError = ...
One of the following:
class BetaErrorResponse: type: "error"; error; request_id
type: Literal["error"]
defaulterror
error: BetaError
One of the following:
request_id: Optional[str]
class BetaGatewayTimeoutError: type: "timeout_error"; message
type: Literal["timeout_error"]
defaulttimeout_error
message: str
defaultRequest timeout
class BetaInvalidRequestError: type: "invalid_request_error"; message
type: Literal["invalid_request_error"]
defaultinvalid_request_error
message: str
defaultInvalid request
class BetaMonetaryAmount: amount; currency

A monetary amount in a specific currency.

amount: str

Amount in minor units of the currency, as an integer decimal string with no leading zeros: "2500" is $25.00 and "50" is fifty cents. A string rather than a number so no float rounding is ever applied.

currency: BetaCurrency

Uppercase ISO-4217 currency code. USD is the only currency currently supported; the accepted set is closed and grows only when a new currency is priced.

class BetaNotFoundError: type: "not_found_error"; message
type: Literal["not_found_error"]
defaultnot_found_error
message: str
defaultNot found
class BetaOverloadedError: type: "overloaded_error"; message
type: Literal["overloaded_error"]
defaultoverloaded_error
message: str
defaultOverloaded
class BetaPermissionError: type: "permission_error"; message
type: Literal["permission_error"]
defaultpermission_error
message: str
defaultPermission denied
class BetaRateLimitError: type: "rate_limit_error"; message
type: Literal["rate_limit_error"]
defaultrate_limit_error
message: str
defaultRate limited

BetaModelle

Modelle auflisten
beta.models.list(**kwargs) -> SyncPage[BetaModelInfo]
GET/v1/models

Liste verfügbare Modelle auf.

Ein Modell abrufen
beta.models.retrieve(model_id, **kwargs) -> BetaModelInfo
GET/v1/models/{model_id}

Rufe ein bestimmtes Modell ab.

Eine Nachricht erstellen
beta.messages.create(**kwargs) -> BetaMessage
POST/v1/messages

Sende eine strukturierte Liste von Eingabenachrichten mit Text- und/oder Bildinhalten, und das Modell generiert die nächste Nachricht in der Konversation.

Tokens in einer Nachricht zählen
beta.messages.count_tokens(**kwargs) -> BetaMessageTokensCount
POST/v1/messages/count_tokens

Zähle die Anzahl der Tokens in einer Nachricht.

BetaNachrichtenBatches

Einen Message Batch erstellen
beta.messages.batches.create(**kwargs) -> BetaMessageBatch
POST/v1/messages/batches

Sende einen Batch von Anfragen zur Erstellung von Nachrichten.

Einen Message Batch abrufen
beta.messages.batches.retrieve(message_batch_id, **kwargs) -> BetaMessageBatch
GET/v1/messages/batches/{message_batch_id}

Dieser Endpunkt ist idempotent und kann verwendet werden, um den Abschluss eines Message Batch per Polling abzufragen. Um auf die Ergebnisse eines Message Batch zuzugreifen, sende eine Anfrage an die im Feld results_url der Antwort angegebene URL.

Message Batches auflisten
beta.messages.batches.list(**kwargs) -> SyncPage[BetaMessageBatch]
GET/v1/messages/batches

Liste alle Message Batches innerhalb eines Workspace auf. Die zuletzt erstellten Batches werden zuerst zurückgegeben.

Einen Message Batch abbrechen
beta.messages.batches.cancel(message_batch_id, **kwargs) -> BetaMessageBatch
POST/v1/messages/batches/{message_batch_id}/cancel

Batches können jederzeit vor Ende der Verarbeitung abgebrochen werden. Sobald der Abbruch eingeleitet wurde, wechselt der Batch in den Zustand canceling; in dieser Zeit kann das System laufende, nicht unterbrechbare Anfragen noch abschließen, bevor der Abbruch finalisiert wird.

Einen Message Batch löschen
beta.messages.batches.delete(message_batch_id, **kwargs) -> BetaDeletedMessageBatch
DELETE/v1/messages/batches/{message_batch_id}

Lösche einen Message Batch.

Ergebnisse eines Message Batch abrufen
beta.messages.batches.results(message_batch_id, **kwargs) -> BetaMessageBatchIndividualResponse
GET/v1/messages/batches/{message_batch_id}/results

Streamt die Ergebnisse eines Message Batch als .jsonl-Datei.

BetaAgenten

Agent erstellen
beta.agents.create(**kwargs) -> BetaManagedAgentsAgent
POST/v1/agents
Agenten auflisten
beta.agents.list(**kwargs) -> SyncPageCursor[BetaManagedAgentsAgent]
GET/v1/agents
Agent abrufen
beta.agents.retrieve(agent_id, **kwargs) -> BetaManagedAgentsAgent
GET/v1/agents/{agent_id}
Agent aktualisieren
beta.agents.update(agent_id, **kwargs) -> BetaManagedAgentsAgent
POST/v1/agents/{agent_id}
Agent archivieren
beta.agents.archive(agent_id, **kwargs) -> BetaManagedAgentsAgent
POST/v1/agents/{agent_id}/archive

BetaAgentenVersionen

Agent-Versionen auflisten
beta.agents.versions.list(agent_id, **kwargs) -> SyncPageCursor[BetaManagedAgentsAgent]
GET/v1/agents/{agent_id}/versions

BetaUmgebungen

Umgebung erstellen
beta.environments.create(**kwargs) -> BetaEnvironment
POST/v1/environments

Erstelle eine neue Umgebung mit der angegebenen Konfiguration.

Umgebungen auflisten
beta.environments.list(**kwargs) -> SyncPageCursor[BetaEnvironment]
GET/v1/environments

Liste Umgebungen mit Unterstützung für Paginierung auf.

Umgebung abrufen
beta.environments.retrieve(environment_id, **kwargs) -> BetaEnvironment
GET/v1/environments/{environment_id}

Rufe eine bestimmte Umgebung anhand ihrer ID ab.

Umgebung aktualisieren
beta.environments.update(environment_id, **kwargs) -> BetaEnvironment
POST/v1/environments/{environment_id}

Aktualisiere die Konfiguration einer bestehenden Umgebung.

Umgebung löschen
beta.environments.delete(environment_id, **kwargs) -> BetaEnvironmentDeleteResponse
DELETE/v1/environments/{environment_id}

Lösche eine Umgebung anhand ihrer ID. Gibt eine Bestätigung der Löschung zurück.

Umgebung archivieren
beta.environments.archive(environment_id, **kwargs) -> BetaEnvironment
POST/v1/environments/{environment_id}/archive

Archiviere eine Umgebung anhand ihrer ID. Archivierte Umgebungen können nicht zum Erstellen neuer Sessions verwendet werden.

BetaUmgebungenArbeit

Arbeitselement abrufen
beta.environments.work.retrieve(work_id, **kwargs) -> BetaSelfHostedWork
GET/v1/environments/{environment_id}/work/{work_id}

Hinweis: Diese Endpunkte werden automatisch vom vorgefertigten Environment-Worker aufgerufen, der in den SDKs und der CLI bereitgestellt wird, um Sessions mit selbst gehosteten Sandbox-Umgebungen zu orchestrieren. Sie sind hier als Referenz aufgeführt; du musst sie nicht direkt aufrufen.

Arbeit per Polling abfragen
beta.environments.work.poll(environment_id, **kwargs) -> BetaSelfHostedWork
GET/v1/environments/{environment_id}/work/poll

Hinweis: Diese Endpunkte werden automatisch vom vorgefertigten Environment-Worker aufgerufen, der in den SDKs und der CLI bereitgestellt wird, um Sessions mit selbst gehosteten Sandbox-Umgebungen zu orchestrieren. Sie sind hier als Referenz aufgeführt; du musst sie nicht direkt aufrufen.

Arbeit bestätigen
beta.environments.work.ack(work_id, **kwargs) -> BetaSelfHostedWork
POST/v1/environments/{environment_id}/work/{work_id}/ack

Hinweis: Diese Endpunkte werden automatisch vom vorgefertigten Environment-Worker aufgerufen, der in den SDKs und der CLI bereitgestellt wird, um Sessions mit selbst gehosteten Sandbox-Umgebungen zu orchestrieren. Sie sind hier als Referenz aufgeführt; du musst sie nicht direkt aufrufen.

Heartbeat aufzeichnen
beta.environments.work.heartbeat(work_id, **kwargs) -> BetaSelfHostedWorkHeartbeatResponse
POST/v1/environments/{environment_id}/work/{work_id}/heartbeat

Hinweis: Diese Endpunkte werden automatisch vom vorgefertigten Environment-Worker aufgerufen, der in den SDKs und der CLI bereitgestellt wird, um Sessions mit selbst gehosteten Sandbox-Umgebungen zu orchestrieren. Sie sind hier als Referenz aufgeführt; du musst sie nicht direkt aufrufen.

Arbeit stoppen
beta.environments.work.stop(work_id, **kwargs) -> BetaSelfHostedWork
POST/v1/environments/{environment_id}/work/{work_id}/stop

Hinweis: Diese Endpunkte werden automatisch vom vorgefertigten Environment-Worker aufgerufen, der in den SDKs und der CLI bereitgestellt wird, um Sessions mit selbst gehosteten Sandbox-Umgebungen zu orchestrieren. Sie sind hier als Referenz aufgeführt; du musst sie nicht direkt aufrufen.

Arbeitselemente auflisten
beta.environments.work.list(environment_id, **kwargs) -> SyncPageCursor[BetaSelfHostedWork]
GET/v1/environments/{environment_id}/work

Hinweis: Diese Endpunkte werden automatisch vom vorgefertigten Environment-Worker aufgerufen, der in den SDKs und der CLI bereitgestellt wird, um Sessions mit selbst gehosteten Sandbox-Umgebungen zu orchestrieren. Sie sind hier als Referenz aufgeführt; du musst sie nicht direkt aufrufen.

Arbeitselement aktualisieren
beta.environments.work.update(work_id, **kwargs) -> BetaSelfHostedWork
POST/v1/environments/{environment_id}/work/{work_id}

Hinweis: Diese Endpunkte werden automatisch vom vorgefertigten Environment-Worker aufgerufen, der in den SDKs und der CLI bereitgestellt wird, um Sessions mit selbst gehosteten Sandbox-Umgebungen zu orchestrieren. Sie sind hier als Referenz aufgeführt; du musst sie nicht direkt aufrufen.

Warteschlangenstatistiken abrufen
beta.environments.work.stats(environment_id, **kwargs) -> BetaSelfHostedWorkQueueStats
GET/v1/environments/{environment_id}/work/stats

Rufe Statistiken über die Arbeitswarteschlange einer Umgebung ab.

BetaSitzungen

Session erstellen
beta.sessions.create(**kwargs) -> BetaManagedAgentsSession
POST/v1/sessions
Sessions auflisten
beta.sessions.list(**kwargs) -> SyncBidirectionalPageCursor[BetaManagedAgentsSession]
GET/v1/sessions
Session abrufen
beta.sessions.retrieve(session_id, **kwargs) -> BetaManagedAgentsSession
GET/v1/sessions/{session_id}
Session aktualisieren
beta.sessions.update(session_id, **kwargs) -> BetaManagedAgentsSession
POST/v1/sessions/{session_id}
Session löschen
beta.sessions.delete(session_id, **kwargs) -> BetaManagedAgentsDeletedSession
DELETE/v1/sessions/{session_id}
Session archivieren
beta.sessions.archive(session_id, **kwargs) -> BetaManagedAgentsSession
POST/v1/sessions/{session_id}/archive

BetaSitzungenEvents

Events auflisten
beta.sessions.events.list(session_id, **kwargs) -> SyncPageCursor[BetaManagedAgentsSessionEvent]
GET/v1/sessions/{session_id}/events
Events senden
beta.sessions.events.send(session_id, **kwargs) -> BetaManagedAgentsSendSessionEvents
POST/v1/sessions/{session_id}/events
Events streamen
beta.sessions.events.stream(session_id, **kwargs) -> BetaManagedAgentsStreamSessionEvents
GET/v1/sessions/{session_id}/events/stream

BetaSitzungenRessourcen

Session-Ressource hinzufügen
beta.sessions.resources.add(session_id, **kwargs) -> BetaManagedAgentsFileResource
POST/v1/sessions/{session_id}/resources
Session-Ressourcen auflisten
beta.sessions.resources.list(session_id, **kwargs) -> SyncPageCursor[BetaManagedAgentsSessionResource]
GET/v1/sessions/{session_id}/resources
Session-Ressource abrufen
beta.sessions.resources.retrieve(resource_id, **kwargs) -> ResourceRetrieveResponse
GET/v1/sessions/{session_id}/resources/{resource_id}
Session-Ressource aktualisieren
beta.sessions.resources.update(resource_id, **kwargs) -> ResourceUpdateResponse
POST/v1/sessions/{session_id}/resources/{resource_id}
Session-Ressource löschen
beta.sessions.resources.delete(resource_id, **kwargs) -> BetaManagedAgentsDeleteSessionResource
DELETE/v1/sessions/{session_id}/resources/{resource_id}

BetaSitzungenThreads

Session-Threads auflisten
beta.sessions.threads.list(session_id, **kwargs) -> SyncPageCursor[BetaManagedAgentsSessionThread]
GET/v1/sessions/{session_id}/threads
Session-Thread abrufen
beta.sessions.threads.retrieve(thread_id, **kwargs) -> BetaManagedAgentsSessionThread
GET/v1/sessions/{session_id}/threads/{thread_id}
Session-Thread archivieren
beta.sessions.threads.archive(thread_id, **kwargs) -> BetaManagedAgentsSessionThread
POST/v1/sessions/{session_id}/threads/{thread_id}/archive

BetaSitzungenThreadsEvents

Session-Thread-Events auflisten
beta.sessions.threads.events.list(thread_id, **kwargs) -> SyncPageCursor[BetaManagedAgentsSessionEvent]
GET/v1/sessions/{session_id}/threads/{thread_id}/events
Session-Thread-Events streamen
beta.sessions.threads.events.stream(thread_id, **kwargs) -> BetaManagedAgentsStreamSessionThreadEvents
GET/v1/sessions/{session_id}/threads/{thread_id}/stream
Deployment erstellen
beta.deployments.create(**kwargs) -> BetaManagedAgentsDeployment
POST/v1/deployments
Deployments auflisten
beta.deployments.list(**kwargs) -> SyncPageCursor[BetaManagedAgentsDeployment]
GET/v1/deployments
Deployment abrufen
beta.deployments.retrieve(deployment_id, **kwargs) -> BetaManagedAgentsDeployment
GET/v1/deployments/{deployment_id}
Deployment aktualisieren
beta.deployments.update(deployment_id, **kwargs) -> BetaManagedAgentsDeployment
POST/v1/deployments/{deployment_id}
Deployment archivieren
beta.deployments.archive(deployment_id, **kwargs) -> BetaManagedAgentsDeployment
POST/v1/deployments/{deployment_id}/archive
Deployment jetzt ausführen
beta.deployments.run(deployment_id, **kwargs) -> BetaManagedAgentsDeploymentRun
POST/v1/deployments/{deployment_id}/run
Deployment pausieren
beta.deployments.pause(deployment_id, **kwargs) -> BetaManagedAgentsDeployment
POST/v1/deployments/{deployment_id}/pause
Deployment fortsetzen
beta.deployments.unpause(deployment_id, **kwargs) -> BetaManagedAgentsDeployment
POST/v1/deployments/{deployment_id}/unpause
Deployment-Runs auflisten
beta.deployment_runs.list(**kwargs) -> SyncPageCursor[BetaManagedAgentsDeploymentRun]
GET/v1/deployment_runs
Deployment-Run abrufen
beta.deployment_runs.retrieve(deployment_run_id, **kwargs) -> BetaManagedAgentsDeploymentRun
GET/v1/deployment_runs/{deployment_run_id}

BetaVaults

Vault erstellen
beta.vaults.create(**kwargs) -> BetaManagedAgentsVault
POST/v1/vaults
Vaults auflisten
beta.vaults.list(**kwargs) -> SyncPageCursor[BetaManagedAgentsVault]
GET/v1/vaults
Vault abrufen
beta.vaults.retrieve(vault_id, **kwargs) -> BetaManagedAgentsVault
GET/v1/vaults/{vault_id}
Vault aktualisieren
beta.vaults.update(vault_id, **kwargs) -> BetaManagedAgentsVault
POST/v1/vaults/{vault_id}
Vault löschen
beta.vaults.delete(vault_id, **kwargs) -> BetaManagedAgentsDeletedVault
DELETE/v1/vaults/{vault_id}
Vault archivieren
beta.vaults.archive(vault_id, **kwargs) -> BetaManagedAgentsVault
POST/v1/vaults/{vault_id}/archive

BetaVaultsAnmeldedaten

Credential erstellen
beta.vaults.credentials.create(vault_id, **kwargs) -> BetaManagedAgentsCredential
POST/v1/vaults/{vault_id}/credentials
Credentials auflisten
beta.vaults.credentials.list(vault_id, **kwargs) -> SyncPageCursor[BetaManagedAgentsCredential]
GET/v1/vaults/{vault_id}/credentials
Credential abrufen
beta.vaults.credentials.retrieve(credential_id, **kwargs) -> BetaManagedAgentsCredential
GET/v1/vaults/{vault_id}/credentials/{credential_id}
Credential aktualisieren
beta.vaults.credentials.update(credential_id, **kwargs) -> BetaManagedAgentsCredential
POST/v1/vaults/{vault_id}/credentials/{credential_id}
Credential löschen
beta.vaults.credentials.delete(credential_id, **kwargs) -> BetaManagedAgentsDeletedCredential
DELETE/v1/vaults/{vault_id}/credentials/{credential_id}
Credential archivieren
beta.vaults.credentials.archive(credential_id, **kwargs) -> BetaManagedAgentsCredential
POST/v1/vaults/{vault_id}/credentials/{credential_id}/archive
Credential validieren
beta.vaults.credentials.mcp_oauth_validate(credential_id, **kwargs) -> BetaManagedAgentsCredentialValidation
POST/v1/vaults/{vault_id}/credentials/{credential_id}/mcp_oauth_validate
Memory Store erstellen
beta.memory_stores.create(**kwargs) -> BetaManagedAgentsMemoryStore
POST/v1/memory_stores
Memory Stores auflisten
beta.memory_stores.list(**kwargs) -> SyncPageCursor[BetaManagedAgentsMemoryStore]
GET/v1/memory_stores
Memory Store abrufen
beta.memory_stores.retrieve(memory_store_id, **kwargs) -> BetaManagedAgentsMemoryStore
GET/v1/memory_stores/{memory_store_id}
Memory Store aktualisieren
beta.memory_stores.update(memory_store_id, **kwargs) -> BetaManagedAgentsMemoryStore
POST/v1/memory_stores/{memory_store_id}
Memory Store löschen
beta.memory_stores.delete(memory_store_id, **kwargs) -> BetaManagedAgentsDeletedMemoryStore
DELETE/v1/memory_stores/{memory_store_id}
Memory Store archivieren
beta.memory_stores.archive(memory_store_id, **kwargs) -> BetaManagedAgentsMemoryStore
POST/v1/memory_stores/{memory_store_id}/archive

BetaMemory StoresMemories

Memory erstellen
beta.memory_stores.memories.create(memory_store_id, **kwargs) -> BetaManagedAgentsMemory
POST/v1/memory_stores/{memory_store_id}/memories
Memories auflisten
beta.memory_stores.memories.list(memory_store_id, **kwargs) -> SyncPageCursor[BetaManagedAgentsMemoryListItem]
GET/v1/memory_stores/{memory_store_id}/memories
Memory abrufen
beta.memory_stores.memories.retrieve(memory_id, **kwargs) -> BetaManagedAgentsMemory
GET/v1/memory_stores/{memory_store_id}/memories/{memory_id}
Memory aktualisieren
beta.memory_stores.memories.update(memory_id, **kwargs) -> BetaManagedAgentsMemory
POST/v1/memory_stores/{memory_store_id}/memories/{memory_id}
Memory löschen
beta.memory_stores.memories.delete(memory_id, **kwargs) -> BetaManagedAgentsDeletedMemory
DELETE/v1/memory_stores/{memory_store_id}/memories/{memory_id}

BetaMemory StoresMemory-Versionen

Memory-Versionen auflisten
beta.memory_stores.memory_versions.list(memory_store_id, **kwargs) -> SyncPageCursor[BetaManagedAgentsMemoryVersion]
GET/v1/memory_stores/{memory_store_id}/memory_versions
Memory-Version abrufen
beta.memory_stores.memory_versions.retrieve(memory_version_id, **kwargs) -> BetaManagedAgentsMemoryVersion
GET/v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id}
Memory-Version schwärzen
beta.memory_stores.memory_versions.redact(memory_version_id, **kwargs) -> BetaManagedAgentsMemoryVersion
POST/v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id}/redact

BetaDateien

Datei hochladen
beta.files.upload(**kwargs) -> BetaFileMetadata
POST/v1/files
Dateien auflisten
beta.files.list(**kwargs) -> SyncPageCursor[BetaFileMetadata]
GET/v1/files
Datei herunterladen
beta.files.download(file_id, **kwargs) -> BinaryResponseContent
GET/v1/files/{file_id}/content
Dateimetadaten abrufen
beta.files.retrieve_metadata(file_id, **kwargs) -> BetaFileMetadata
GET/v1/files/{file_id}
Datei löschen
beta.files.delete(file_id, **kwargs) -> BetaDeletedFile
DELETE/v1/files/{file_id}

BetaSkills

Skill erstellen
beta.skills.create(**kwargs) -> BetaSkill
POST/v1/skills
Skills auflisten
beta.skills.list(**kwargs) -> SyncPageCursor[BetaSkill]
GET/v1/skills
Skill abrufen
beta.skills.retrieve(skill_id, **kwargs) -> BetaSkill
GET/v1/skills/{skill_id}
Skill löschen
beta.skills.delete(skill_id, **kwargs) -> BetaDeletedSkill
DELETE/v1/skills/{skill_id}

BetaSkillsVersionen

Skill-Version erstellen
beta.skills.versions.create(skill_id, **kwargs) -> BetaSkillVersion
POST/v1/skills/{skill_id}/versions
Skill-Versionen auflisten
beta.skills.versions.list(skill_id, **kwargs) -> SyncPageCursor[BetaSkillVersion]
GET/v1/skills/{skill_id}/versions
Inhalt einer Skill-Version herunterladen
beta.skills.versions.download(version, **kwargs) -> BinaryResponseContent
GET/v1/skills/{skill_id}/versions/{version}/content

Lädt den Inhalt einer Skill-Version als ZIP-Archiv herunter.

Skill-Version abrufen
beta.skills.versions.retrieve(version, **kwargs) -> BetaSkillVersion
GET/v1/skills/{skill_id}/versions/{version}
Skill-Version löschen
beta.skills.versions.delete(version, **kwargs) -> BetaDeletedSkillVersion
DELETE/v1/skills/{skill_id}/versions/{version}
Benutzerprofil erstellen
beta.user_profiles.create(**kwargs) -> BetaUserProfile
POST/v1/user_profiles
Benutzerprofile auflisten
beta.user_profiles.list(**kwargs) -> SyncPageCursor[BetaUserProfile]
GET/v1/user_profiles
Benutzerprofil abrufen
beta.user_profiles.retrieve(user_profile_id, **kwargs) -> BetaUserProfile
GET/v1/user_profiles/{user_profile_id}
Benutzerprofil aktualisieren
beta.user_profiles.update(user_profile_id, **kwargs) -> BetaUserProfile
POST/v1/user_profiles/{user_profile_id}
Enrollment-URL erstellen
beta.user_profiles.create_enrollment_url(user_profile_id, **kwargs) -> BetaUserProfileEnrollmentURL
POST/v1/user_profiles/{user_profile_id}/enrollment_url

BetaDreams

Dream erstellen
beta.dreams.create(**kwargs) -> BetaDream
POST/v1/dreams

Startet einen asynchronen Job, der vergangene Sessions nutzt, um eine neu organisierte Version eines Memory Stores zu erzeugen, und gibt den Dream zurück, den du für das Ergebnis abfragen kannst.

Dreams auflisten
beta.dreams.list(**kwargs) -> SyncPageCursor[BetaDream]
GET/v1/dreams

Listet die Dreams im Workspace auf, die neuesten zuerst.

Dream abrufen
beta.dreams.retrieve(dream_id, **kwargs) -> BetaDream
GET/v1/dreams/{dream_id}

Ruft einen Dream anhand seiner ID ab, um seinen Status, den Ausgabe-Memory-Store und die Token-Nutzung zu prüfen.

Dream abbrechen
beta.dreams.cancel(dream_id, **kwargs) -> BetaDream
POST/v1/dreams/{dream_id}/cancel

Stoppt einen Dream mit dem Status pending oder running.

Dream archivieren
beta.dreams.archive(dream_id, **kwargs) -> BetaDream
POST/v1/dreams/{dream_id}/archive

Blendet einen Dream mit dem Status completed, failed oder canceled aus der Standardliste der Dreams aus.

BetaTunnel

Tunnel erstellen
beta.tunnels.create(**kwargs) -> BetaTunnel
POST/v1/tunnels

Die Tunnels API befindet sich in der "Research Preview" (Forschungsvorschau). Sie erfordert den Header anthropic-beta: mcp-tunnels-2026-06-22 und kann sich ohne Abkündigungsfrist ändern. Sie ersetzt die Admin-API-Endpunkte unter /v1/organizations/tunnels, die während eines Migrationszeitraums weiterhin verfügbar bleiben.

Tunnel abrufen
beta.tunnels.retrieve(tunnel_id, **kwargs) -> BetaTunnel
GET/v1/tunnels/{tunnel_id}

Die Tunnels API befindet sich in der "Research Preview" (Forschungsvorschau). Sie erfordert den Header anthropic-beta: mcp-tunnels-2026-06-22 und kann sich ohne Abkündigungsfrist ändern. Sie ersetzt die Admin-API-Endpunkte unter /v1/organizations/tunnels, die während eines Migrationszeitraums weiterhin verfügbar bleiben.

Tunnels auflisten
beta.tunnels.list(**kwargs) -> SyncPageCursor[BetaTunnel]
GET/v1/tunnels

Die Tunnels API befindet sich in der "Research Preview" (Forschungsvorschau). Sie erfordert den Header anthropic-beta: mcp-tunnels-2026-06-22 und kann sich ohne Abkündigungsfrist ändern. Sie ersetzt die Admin-API-Endpunkte unter /v1/organizations/tunnels, die während eines Migrationszeitraums weiterhin verfügbar bleiben.

Tunnel archivieren
beta.tunnels.archive(tunnel_id, **kwargs) -> BetaTunnel
POST/v1/tunnels/{tunnel_id}/archive

Die Tunnels API befindet sich in der "Research Preview" (Forschungsvorschau). Sie erfordert den Header anthropic-beta: mcp-tunnels-2026-06-22 und kann sich ohne Abkündigungsfrist ändern. Sie ersetzt die Admin-API-Endpunkte unter /v1/organizations/tunnels, die während eines Migrationszeitraums weiterhin verfügbar bleiben.

Tunnel-Token anzeigen
beta.tunnels.reveal_token(tunnel_id, **kwargs) -> BetaTunnelToken
POST/v1/tunnels/{tunnel_id}/reveal_token

Die Tunnels API befindet sich in der "Research Preview" (Forschungsvorschau). Sie erfordert den Header anthropic-beta: mcp-tunnels-2026-06-22 und kann sich ohne Abkündigungsfrist ändern. Sie ersetzt die Admin-API-Endpunkte unter /v1/organizations/tunnels, die während eines Migrationszeitraums weiterhin verfügbar bleiben.

Tunnel-Token rotieren
beta.tunnels.rotate_token(tunnel_id, **kwargs) -> BetaTunnelToken
POST/v1/tunnels/{tunnel_id}/rotate_token

Die Tunnels API befindet sich in der "Research Preview" (Forschungsvorschau). Sie erfordert den Header anthropic-beta: mcp-tunnels-2026-06-22 und kann sich ohne Abkündigungsfrist ändern. Sie ersetzt die Admin-API-Endpunkte unter /v1/organizations/tunnels, die während eines Migrationszeitraums weiterhin verfügbar bleiben.

BetaTunnelZertifikate

Tunnel-Zertifikat erstellen
beta.tunnels.certificates.create(tunnel_id, **kwargs) -> BetaTunnelCertificate
POST/v1/tunnels/{tunnel_id}/certificates

Die Tunnels API befindet sich in der "Research Preview" (Forschungsvorschau). Sie erfordert den Header anthropic-beta: mcp-tunnels-2026-06-22 und kann sich ohne Abkündigungsfrist ändern. Sie ersetzt die Admin-API-Endpunkte unter /v1/organizations/tunnels, die während eines Migrationszeitraums weiterhin verfügbar bleiben.

Tunnel-Zertifikat abrufen
beta.tunnels.certificates.retrieve(certificate_id, **kwargs) -> BetaTunnelCertificate
GET/v1/tunnels/{tunnel_id}/certificates/{certificate_id}

Die Tunnels API befindet sich in der "Research Preview" (Forschungsvorschau). Sie erfordert den Header anthropic-beta: mcp-tunnels-2026-06-22 und kann sich ohne Abkündigungsfrist ändern. Sie ersetzt die Admin-API-Endpunkte unter /v1/organizations/tunnels, die während eines Migrationszeitraums weiterhin verfügbar bleiben.

Tunnel-Zertifikate auflisten
beta.tunnels.certificates.list(tunnel_id, **kwargs) -> SyncPageCursor[BetaTunnelCertificate]
GET/v1/tunnels/{tunnel_id}/certificates

Die Tunnels API befindet sich in der "Research Preview" (Forschungsvorschau). Sie erfordert den Header anthropic-beta: mcp-tunnels-2026-06-22 und kann sich ohne Abkündigungsfrist ändern. Sie ersetzt die Admin-API-Endpunkte unter /v1/organizations/tunnels, die während eines Migrationszeitraums weiterhin verfügbar bleiben.

Tunnel-Zertifikat archivieren
beta.tunnels.certificates.archive(certificate_id, **kwargs) -> BetaTunnelCertificate
POST/v1/tunnels/{tunnel_id}/certificates/{certificate_id}/archive

Die Tunnels API befindet sich in der "Research Preview" (Forschungsvorschau). Sie erfordert den Header anthropic-beta: mcp-tunnels-2026-06-22 und kann sich ohne Abkündigungsfrist ändern. Sie ersetzt die Admin-API-Endpunkte unter /v1/organizations/tunnels, die während eines Migrationszeitraums weiterhin verfügbar bleiben.

Aktuelle Organisation abrufen
beta.organization.retrieve() -> BetaOrganization
GET/v1/organizations/me

Ruft Informationen über die Organisation ab, die mit dem authentifizierten API-Key verknüpft ist.

BetaOrganisationAPI-Keys

API-Keys auflisten
beta.organization.api_keys.list(**kwargs) -> SyncPage[BetaAPIKey]
GET/v1/organizations/api_keys
API-Key abrufen (Admin API)
beta.organization.api_keys.retrieve(api_key_id) -> BetaAPIKey
GET/v1/organizations/api_keys/{api_key_id}

Ruft Informationen über einen einzelnen API-Key in deiner Organisation ab, der anhand seiner ID gesucht wird. Dieser Admin-API-Endpunkt erfordert einen Admin-API-Key, ist für die programmatische Key-Verwaltung vorgesehen und gibt niemals den geheimen Wert des Keys zurück. Um deine eigenen API-Keys anzuzeigen oder zu erstellen, gehe in der Claude Console zu API-Keys.

API-Key aktualisieren
beta.organization.api_keys.update(api_key_id, **kwargs) -> BetaAPIKey
POST/v1/organizations/api_keys/{api_key_id}

BetaOrganisationExterne Keys

Externen Key erstellen
beta.organization.external_keys.create(**kwargs) -> BetaExternalKey
POST/v1/organizations/external_keys

Erstellt eine externe Key-Konfiguration, die der Organisation des Aufrufers gehört.

Externe Keys auflisten
beta.organization.external_keys.list(**kwargs) -> SyncPageCursor[BetaExternalKey]
GET/v1/organizations/external_keys

Listet externe Key-Konfigurationen in der Organisation des Aufrufers auf.

Externen Key abrufen
beta.organization.external_keys.retrieve(external_key_id) -> BetaExternalKey
GET/v1/organizations/external_keys/{external_key_id}

Ruft eine einzelne externe Key-Konfiguration in der Organisation des Aufrufers anhand der ID ab.

Externen Key aktualisieren
beta.organization.external_keys.update(external_key_id, **kwargs) -> BetaExternalKey
POST/v1/organizations/external_keys/{external_key_id}

Aktualisiert eine externe Key-Konfiguration teilweise. Ausgelassene Felder bleiben unverändert.

Externen Key löschen
beta.organization.external_keys.delete(external_key_id) -> ExternalKeyDeleteResponse
DELETE/v1/organizations/external_keys/{external_key_id}

Löscht eine externe Key-Konfiguration.

Externen Key validieren
beta.organization.external_keys.validate(external_key_id) -> ExternalKeyValidateResponse
POST/v1/organizations/external_keys/{external_key_id}/validate

Validiert eine externe Key-Konfiguration gegen das KMS des Kunden.

BetaOrganisationFöderationIssuer

Federation-Issuer erstellen
beta.organization.federation.issuers.create(**kwargs) -> BetaFederationIssuer
POST/v1/organizations/federation_issuers

Erfordert ein OAuth-Zugriffstoken mit dem Scope org:admin, über ant auth login --scope org:admin oder eine Workload-Identity-Federation-Regel; Admin-API-Keys werden nicht akzeptiert. Siehe WIF mit der Admin API verwalten.

Federation-Issuer auflisten
beta.organization.federation.issuers.list(**kwargs) -> SyncPageCursor[BetaFederationIssuer]
GET/v1/organizations/federation_issuers

Erfordert ein OAuth-Zugriffstoken mit dem Scope org:admin, über ant auth login --scope org:admin oder eine Workload-Identity-Federation-Regel; Admin-API-Keys werden nicht akzeptiert. Siehe WIF mit der Admin API verwalten.

Federation-Issuer abrufen
beta.organization.federation.issuers.retrieve(federation_issuer_id, **kwargs) -> BetaFederationIssuer
GET/v1/organizations/federation_issuers/{federation_issuer_id}

Erfordert ein OAuth-Zugriffstoken mit dem Scope org:admin, über ant auth login --scope org:admin oder eine Workload-Identity-Federation-Regel; Admin-API-Keys werden nicht akzeptiert. Siehe WIF mit der Admin API verwalten.

Federation-Issuer aktualisieren
beta.organization.federation.issuers.update(federation_issuer_id, **kwargs) -> BetaFederationIssuer
POST/v1/organizations/federation_issuers/{federation_issuer_id}

Erfordert ein OAuth-Zugriffstoken mit dem Scope org:admin, über ant auth login --scope org:admin oder eine Workload-Identity-Federation-Regel; Admin-API-Keys werden nicht akzeptiert. Siehe WIF mit der Admin API verwalten.

Federation-Issuer archivieren
beta.organization.federation.issuers.archive(federation_issuer_id, **kwargs) -> BetaFederationIssuer
POST/v1/organizations/federation_issuers/{federation_issuer_id}/archive

Erfordert ein OAuth-Zugriffstoken mit dem Scope org:admin, über ant auth login --scope org:admin oder eine Workload-Identity-Federation-Regel; Admin-API-Keys werden nicht akzeptiert. Siehe WIF mit der Admin API verwalten.

BetaOrganisationFöderationRegeln

Federation-Regel erstellen
beta.organization.federation.rules.create(**kwargs) -> BetaFederationRule
POST/v1/organizations/federation_rules

Erfordert ein OAuth-Zugriffstoken mit dem Scope org:admin, über ant auth login --scope org:admin oder eine Workload-Identity-Federation-Regel; Admin-API-Keys werden nicht akzeptiert. Siehe WIF mit der Admin API verwalten.

Federation-Regeln auflisten
beta.organization.federation.rules.list(**kwargs) -> SyncPageCursor[BetaFederationRule]
GET/v1/organizations/federation_rules

Erfordert ein OAuth-Zugriffstoken mit dem Scope org:admin, über ant auth login --scope org:admin oder eine Workload-Identity-Federation-Regel; Admin-API-Keys werden nicht akzeptiert. Siehe WIF mit der Admin API verwalten.

Federation-Regel abrufen
beta.organization.federation.rules.retrieve(federation_rule_id, **kwargs) -> BetaFederationRule
GET/v1/organizations/federation_rules/{federation_rule_id}

Erfordert ein OAuth-Zugriffstoken mit dem Scope org:admin, über ant auth login --scope org:admin oder eine Workload-Identity-Federation-Regel; Admin-API-Keys werden nicht akzeptiert. Siehe WIF mit der Admin API verwalten.

Federation-Regel aktualisieren
beta.organization.federation.rules.update(federation_rule_id, **kwargs) -> BetaFederationRule
POST/v1/organizations/federation_rules/{federation_rule_id}

Erfordert ein OAuth-Zugriffstoken mit dem Scope org:admin, über ant auth login --scope org:admin oder eine Workload-Identity-Federation-Regel; Admin-API-Keys werden nicht akzeptiert. Siehe WIF mit der Admin API verwalten.

Federation-Regel archivieren
beta.organization.federation.rules.archive(federation_rule_id, **kwargs) -> BetaFederationRule
POST/v1/organizations/federation_rules/{federation_rule_id}/archive

Erfordert ein OAuth-Zugriffstoken mit dem Scope org:admin, über ant auth login --scope org:admin oder eine Workload-Identity-Federation-Regel; Admin-API-Keys werden nicht akzeptiert. Siehe WIF mit der Admin API verwalten.

BetaOrganisationFöderationRegelnWorkspaces

Workspace zu Federation-Regel hinzufügen
beta.organization.federation.rules.workspaces.add(federation_rule_id, **kwargs) -> BetaFederationRuleWorkspace
POST/v1/organizations/federation_rules/{federation_rule_id}/workspaces

Erfordert ein OAuth-Zugriffstoken mit dem Scope org:admin, über ant auth login --scope org:admin oder eine Workload-Identity-Federation-Regel; Admin-API-Keys werden nicht akzeptiert. Siehe WIF mit der Admin API verwalten.

Workspaces einer Federation-Regel auflisten
beta.organization.federation.rules.workspaces.list(federation_rule_id, **kwargs) -> SyncPageCursor[BetaFederationRuleWorkspace]
GET/v1/organizations/federation_rules/{federation_rule_id}/workspaces

Erfordert ein OAuth-Zugriffstoken mit dem Scope org:admin, über ant auth login --scope org:admin oder eine Workload-Identity-Federation-Regel; Admin-API-Keys werden nicht akzeptiert. Siehe WIF mit der Admin API verwalten.

Workspace aus Federation-Regel entfernen
beta.organization.federation.rules.workspaces.remove(workspace_id, **kwargs) -> WorkspaceRemoveResponse
DELETE/v1/organizations/federation_rules/{federation_rule_id}/workspaces/{workspace_id}

Erfordert ein OAuth-Zugriffstoken mit dem Scope org:admin, über ant auth login --scope org:admin oder eine Workload-Identity-Federation-Regel; Admin-API-Keys werden nicht akzeptiert. Siehe WIF mit der Admin API verwalten.

BetaOrganisationEinladungen

Einladung erstellen
beta.organization.invites.create(**kwargs) -> BetaOrganizationInvite
POST/v1/organizations/invites

Lädt einen Benutzer per E-Mail ein, der Organisation beizutreten.

Einladungen auflisten
beta.organization.invites.list(**kwargs) -> SyncPage[BetaOrganizationInvite]
GET/v1/organizations/invites

Listet die Einladungen der Organisation auf.

Einladung abrufen
beta.organization.invites.retrieve(invite_id) -> BetaOrganizationInvite
GET/v1/organizations/invites/{invite_id}

Ruft eine Einladung anhand der ID ab.

Einladung löschen
beta.organization.invites.delete(invite_id) -> InviteDeleteResponse
DELETE/v1/organizations/invites/{invite_id}

Löscht eine ausstehende Einladung.

BetaOrganisationService-Accounts

Service-Account erstellen
beta.organization.service_accounts.create(**kwargs) -> BetaServiceAccount
POST/v1/organizations/service_accounts

Erfordert ein OAuth-Zugriffstoken mit dem Scope org:admin, über ant auth login --scope org:admin oder eine Workload-Identity-Federation-Regel; Admin-API-Keys werden nicht akzeptiert. Siehe WIF mit der Admin API verwalten.

Service-Accounts auflisten
beta.organization.service_accounts.list(**kwargs) -> SyncPageCursor[BetaServiceAccount]
GET/v1/organizations/service_accounts

Erfordert ein OAuth-Zugriffstoken mit dem Scope org:admin, über ant auth login --scope org:admin oder eine Workload-Identity-Federation-Regel; Admin-API-Keys werden nicht akzeptiert. Siehe WIF mit der Admin API verwalten.

Service-Account abrufen
beta.organization.service_accounts.retrieve(service_account_id, **kwargs) -> BetaServiceAccount
GET/v1/organizations/service_accounts/{service_account_id}

Erfordert ein OAuth-Zugriffstoken mit dem Scope org:admin, über ant auth login --scope org:admin oder eine Workload-Identity-Federation-Regel; Admin-API-Keys werden nicht akzeptiert. Siehe WIF mit der Admin API verwalten.

Service-Account aktualisieren
beta.organization.service_accounts.update(service_account_id, **kwargs) -> BetaServiceAccount
POST/v1/organizations/service_accounts/{service_account_id}

Erfordert ein OAuth-Zugriffstoken mit dem Scope org:admin, über ant auth login --scope org:admin oder eine Workload-Identity-Federation-Regel; Admin-API-Keys werden nicht akzeptiert. Siehe WIF mit der Admin API verwalten.

Service-Account archivieren
beta.organization.service_accounts.archive(service_account_id, **kwargs) -> BetaServiceAccount
POST/v1/organizations/service_accounts/{service_account_id}/archive

Erfordert ein OAuth-Zugriffstoken mit dem Scope org:admin, über ant auth login --scope org:admin oder eine Workload-Identity-Federation-Regel; Admin-API-Keys werden nicht akzeptiert. Siehe WIF mit der Admin API verwalten.

BetaOrganisationService-AccountsWorkspaces

Workspace zu Service-Account hinzufügen
beta.organization.service_accounts.workspaces.add(service_account_id, **kwargs) -> BetaServiceAccountWorkspaceMember
POST/v1/organizations/service_accounts/{service_account_id}/workspaces

Erfordert ein OAuth-Zugriffstoken mit dem Scope org:admin, über ant auth login --scope org:admin oder eine Workload-Identity-Federation-Regel; Admin-API-Keys werden nicht akzeptiert. Siehe WIF mit der Admin API verwalten.

Workspaces eines Service-Accounts auflisten
beta.organization.service_accounts.workspaces.list(service_account_id, **kwargs) -> SyncPageCursor[BetaServiceAccountWorkspaceMember]
GET/v1/organizations/service_accounts/{service_account_id}/workspaces

Erfordert ein OAuth-Zugriffstoken mit dem Scope org:admin, über ant auth login --scope org:admin oder eine Workload-Identity-Federation-Regel; Admin-API-Keys werden nicht akzeptiert. Siehe WIF mit der Admin API verwalten.

Workspace aus Service-Account entfernen
beta.organization.service_accounts.workspaces.remove(workspace_id, **kwargs) -> WorkspaceRemoveResponse
DELETE/v1/organizations/service_accounts/{service_account_id}/workspaces/{workspace_id}

Erfordert ein OAuth-Zugriffstoken mit dem Scope org:admin, über ant auth login --scope org:admin oder eine Workload-Identity-Federation-Regel; Admin-API-Keys werden nicht akzeptiert. Siehe WIF mit der Admin API verwalten.

BetaOrganisationBenutzer

Benutzer auflisten
beta.organization.users.list(**kwargs) -> SyncPage[BetaOrganizationUser]
GET/v1/organizations/users

Listet die Mitglieder der Organisation auf.

Benutzer abrufen
beta.organization.users.retrieve(user_id) -> BetaOrganizationUser
GET/v1/organizations/users/{user_id}

Ruft ein Mitglied der Organisation anhand der Benutzer-ID ab.

Benutzer aktualisieren
beta.organization.users.update(user_id, **kwargs) -> BetaOrganizationUser
POST/v1/organizations/users/{user_id}

Aktualisiert die Organisationsrolle eines Mitglieds.

Benutzer entfernen
beta.organization.users.remove(user_id) -> UserRemoveResponse
DELETE/v1/organizations/users/{user_id}

Entfernt ein Mitglied aus der Organisation.

BetaOrganisationWorkspaces

Workspaces auflisten
beta.organization.workspaces.list(**kwargs) -> SyncPage[BetaWorkspace]
GET/v1/organizations/workspaces
Workspace erstellen
beta.organization.workspaces.create(**kwargs) -> BetaWorkspace
POST/v1/organizations/workspaces
Workspace abrufen
beta.organization.workspaces.retrieve(workspace_id) -> BetaWorkspace
GET/v1/organizations/workspaces/{workspace_id}
Workspace aktualisieren
beta.organization.workspaces.update(workspace_id, **kwargs) -> BetaWorkspace
POST/v1/organizations/workspaces/{workspace_id}
Workspace archivieren
beta.organization.workspaces.archive(workspace_id) -> BetaWorkspace
POST/v1/organizations/workspaces/{workspace_id}/archive

BetaOrganisationWorkspacesRatenlimits

Workspace-Ratenlimits auflisten
beta.organization.workspaces.rate_limits.list(workspace_id, **kwargs) -> SyncPageCursor[BetaWorkspaceRateLimit]
GET/v1/organizations/workspaces/{workspace_id}/rate_limits

Listet die Ratenlimits eines Workspace auf.

BetaOrganisationWorkspacesMitglieder

Workspace-Mitglieder auflisten
beta.organization.workspaces.members.list(workspace_id, **kwargs) -> SyncPage[BetaWorkspaceMember]
GET/v1/organizations/workspaces/{workspace_id}/members
Workspace-Mitglied erstellen
beta.organization.workspaces.members.add(workspace_id, **kwargs) -> BetaWorkspaceMember
POST/v1/organizations/workspaces/{workspace_id}/members
Workspace-Mitglied abrufen
beta.organization.workspaces.members.retrieve(user_id, **kwargs) -> BetaWorkspaceMember
GET/v1/organizations/workspaces/{workspace_id}/members/{user_id}
Workspace-Mitglied aktualisieren
beta.organization.workspaces.members.update(user_id, **kwargs) -> BetaWorkspaceMember
POST/v1/organizations/workspaces/{workspace_id}/members/{user_id}
Workspace-Mitglied löschen
beta.organization.workspaces.members.remove(user_id, **kwargs) -> MemberRemoveResponse
DELETE/v1/organizations/workspaces/{workspace_id}/members/{user_id}

BetaOrganisationWorkspacesService-Accounts

Service-Account-Mitglieder eines Workspace auflisten
beta.organization.workspaces.service_accounts.list(workspace_id, **kwargs) -> SyncPageCursor[BetaServiceAccountWorkspaceMember]
GET/v1/organizations/workspaces/{workspace_id}/service_accounts

Erfordert ein OAuth-Zugriffstoken mit dem Scope org:admin, über ant auth login --scope org:admin oder eine Workload-Identity-Federation-Regel; Admin-API-Keys werden nicht akzeptiert. Siehe WIF mit der Admin API verwalten.

Service-Account-Mitglied eines Workspace erstellen
beta.organization.workspaces.service_accounts.add(workspace_id, **kwargs) -> BetaServiceAccountWorkspaceMember
POST/v1/organizations/workspaces/{workspace_id}/service_accounts

Erfordert ein OAuth-Zugriffstoken mit dem Scope org:admin, über ant auth login --scope org:admin oder eine Workload-Identity-Federation-Regel; Admin-API-Keys werden nicht akzeptiert. Siehe WIF mit der Admin API verwalten.

Service-Account-Mitglied eines Workspace abrufen
beta.organization.workspaces.service_accounts.retrieve(service_account_id, **kwargs) -> BetaServiceAccountWorkspaceMember
GET/v1/organizations/workspaces/{workspace_id}/service_accounts/{service_account_id}

Erfordert ein OAuth-Zugriffstoken mit dem Scope org:admin, über ant auth login --scope org:admin oder eine Workload-Identity-Federation-Regel; Admin-API-Keys werden nicht akzeptiert. Siehe WIF mit der Admin API verwalten.

Service-Account-Mitglied eines Workspace aktualisieren
beta.organization.workspaces.service_accounts.update(service_account_id, **kwargs) -> BetaServiceAccountWorkspaceMember
POST/v1/organizations/workspaces/{workspace_id}/service_accounts/{service_account_id}

Erfordert ein OAuth-Zugriffstoken mit dem Scope org:admin, über ant auth login --scope org:admin oder eine Workload-Identity-Federation-Regel; Admin-API-Keys werden nicht akzeptiert. Siehe WIF mit der Admin API verwalten.

Service-Account-Mitglied eines Workspace löschen
beta.organization.workspaces.service_accounts.remove(service_account_id, **kwargs) -> ServiceAccountRemoveResponse
DELETE/v1/organizations/workspaces/{workspace_id}/service_accounts/{service_account_id}

Erfordert ein OAuth-Access-Token mit dem Scope org:admin, erhältlich über ant auth login --scope org:admin oder eine Workload-Identity-Federation-Regel; Admin-API-Keys werden nicht akzeptiert. Siehe WIF mit der Admin API verwalten.

BetaOrganisationRatenlimits

Ratenlimits der Organisation auflisten
beta.organization.rate_limits.list(**kwargs) -> SyncPageCursor[BetaOrganizationRateLimit]
GET/v1/organizations/rate_limits

Listet die Ratenlimits der Messages API für deine Organisation auf.

BetaOrganisationCompliance-Einstellungen

Compliance-Einstellungen abrufen
beta.organization.compliance_settings.retrieve() -> BetaComplianceSettings
GET/v1/organizations/compliance_settings

Ruft die Compliance Settings deiner Organisation ab.

Compliance-Einstellungen aktualisieren
beta.organization.compliance_settings.update(**kwargs) -> BetaComplianceSettings
POST/v1/organizations/compliance_settings

Aktualisiert die Compliance Settings deiner Organisation.

BetaOrganisationAnalysenZusammenfassungen

Aktivitätszusammenfassungen abrufen
beta.organization.analytics.summaries.list(**kwargs) -> SyncPageCursor[BetaAnalyticsSingleDayActivitySummary]
GET/v1/organizations/analytics/summaries

Ruft organisationsweite Aktivitätszusammenfassungen für einen Datumsbereich ab.

BetaOrganisationAnalysenBenutzer

Benutzeraktivität auflisten
beta.organization.analytics.users.list(**kwargs) -> SyncPageCursor[BetaAnalyticsUserActivity]
GET/v1/organizations/analytics/users

Ruft die Aktivität pro Benutzer für einen bestimmten Tag ab, mit Cursor-basierter Paginierung.

BetaOrganisationAnalysenAppsChatProjekte

Chat-Projektnutzung abrufen
beta.organization.analytics.apps.chat.projects.list(**kwargs) -> SyncPageCursor[BetaAnalyticsProjectActivity]
GET/v1/organizations/analytics/apps/chat/projects

Ruft die Aktivität pro Projekt für einen bestimmten Tag ab, mit cursorbasierter Paginierung.

BetaOrganisationAnalysenKonnektoren

Konnektor-Nutzung abrufen
beta.organization.analytics.connectors.list(**kwargs) -> SyncPageCursor[BetaAnalyticsConnectorActivity]
GET/v1/organizations/analytics/connectors

Ruft die Nutzung pro Konnektor für einen bestimmten Tag ab, mit Cursor-basierter Paginierung.

BetaOrganisationAnalysenPlugins

Plugin-Nutzung abrufen
beta.organization.analytics.plugins.list(**kwargs) -> SyncPageCursor[BetaAnalyticsPluginActivity]
GET/v1/organizations/analytics/plugins

Ruft die Installations- und Aufrufnutzung pro Plugin für einen bestimmten Tag ab, mit Paginierung.

BetaOrganisationAnalysenSkills

Skill-Nutzung abrufen
beta.organization.analytics.skills.list(**kwargs) -> SyncPageCursor[BetaAnalyticsSkillActivity]
GET/v1/organizations/analytics/skills

Ruft die Nutzung pro Skill für einen bestimmten Tag ab, mit Cursor-basierter Paginierung.

BetaOrganisationAnalysenArtifacts

Artifact-Aktivität abrufen
beta.organization.analytics.artifacts.list(**kwargs) -> SyncPageCursor[BetaAnalyticsArtifactActivity]
GET/v1/organizations/analytics/artifacts

Ruft die Aktivität zur Artifact-Erstellung für einen bestimmten Tag ab, aufgeschlüsselt nach MIME-Typ.

BetaOrganisationAnalysenNutzungsbericht

Token-Nutzung im Zeitverlauf abrufen
beta.organization.analytics.usage_report.list(**kwargs) -> SyncPageCursor[BetaAnalyticsUsageReportTimeBucket]
GET/v1/organizations/analytics/usage_report

Ruft die Token-Nutzung im Zeitverlauf über einen Datumsbereich ab.

BetaOrganisationAnalysenNutzungsbericht pro Benutzer

Token-Nutzung pro Benutzer abrufen
beta.organization.analytics.user_usage_report.list(**kwargs) -> SyncPageCursor[BetaAnalyticsUsageUsersItem]
GET/v1/organizations/analytics/user_usage_report

Ruft die Token-Nutzung pro Benutzer über einen Datumsbereich ab.

BetaOrganisationAnalysenKostenbericht

Kosten im Zeitverlauf abrufen
beta.organization.analytics.cost_report.list(**kwargs) -> SyncPageCursor[BetaAnalyticsCostReportTimeBucket]
GET/v1/organizations/analytics/cost_report

Ruft die Kosten in USD im Zeitverlauf über einen Datumsbereich ab.

BetaOrganisationAnalysenKostenbericht pro Benutzer

Kosten pro Benutzer abrufen
beta.organization.analytics.user_cost_report.list(**kwargs) -> SyncPageCursor[BetaAnalyticsCostUsersItem]
GET/v1/organizations/analytics/user_cost_report

Ruft die Kosten pro Benutzer in USD über einen Datumsbereich ab.

BetaOrganisationAusgabenlimits

Ausgabenlimit festlegen
beta.organization.spend_limits.set(**kwargs) -> BetaSpendLimit
POST/v1/organizations/spend_limits

Legt ein Ausgabenlimit fest.

Ausgabenlimit abrufen
beta.organization.spend_limits.retrieve(spend_limit_id) -> BetaSpendLimit
GET/v1/organizations/spend_limits/{spend_limit_id}

Ruft ein Ausgabenlimit anhand seiner ID ab.

Ausgabenlimit löschen
beta.organization.spend_limits.delete(spend_limit_id) -> SpendLimitDeleteResponse
DELETE/v1/organizations/spend_limits/{spend_limit_id}

Löscht ein Ausgabenlimit.

Ausgabenlimits auflisten
beta.organization.spend_limits.list(**kwargs) -> SyncPageCursor[BetaSpendLimit]
GET/v1/organizations/spend_limits

Listet die Ausgabenlimits der Organisation auf.

BetaOrganisationAusgabenlimitsEffektiv

Effektive Ausgabenlimits auflisten
beta.organization.spend_limits.effective.list(**kwargs) -> SyncPageCursor[BetaSpendSummary]
GET/v1/organizations/spend_limits/effective

Listet für jedes Mitglied das effektive Ausgabenlimit und die bisherigen Ausgaben im Zeitraum auf.

BetaOrganisationAusgabenlimitsErhöhungsanfragen

Anfragen zur Erhöhung des Ausgabenlimits auflisten
beta.organization.spend_limits.increase_requests.list(**kwargs) -> SyncPageCursor[BetaSpendLimitIncreaseRequest]
GET/v1/organizations/spend_limit_increase_requests

Listet Anfragen zur Erhöhung des Ausgabenlimits auf, neueste zuerst.

Anfrage zur Erhöhung des Ausgabenlimits abrufen
beta.organization.spend_limits.increase_requests.retrieve(spend_limit_increase_request_id) -> BetaSpendLimitIncreaseRequest
GET/v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}

Ruft eine Anfrage zur Erhöhung des Ausgabenlimits ab.

Anfrage zur Erhöhung des Ausgabenlimits genehmigen
beta.organization.spend_limits.increase_requests.approve(spend_limit_increase_request_id, **kwargs) -> IncreaseRequestApproveResponse
POST/v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}/approve

Genehmigt eine ausstehende Anfrage zur Erhöhung des Ausgabenlimits.

Anfrage zur Erhöhung des Ausgabenlimits ablehnen
beta.organization.spend_limits.increase_requests.deny(spend_limit_increase_request_id, **kwargs) -> BetaSpendLimitIncreaseRequest
POST/v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}/deny

Lehnt eine ausstehende Anfrage zur Erhöhung des Ausgabenlimits ab.

BetaOrganisationRBAC-Gruppen

RBAC-Gruppe erstellen
beta.organization.rbac_groups.create(**kwargs) -> BetaRBACGroup
POST/v1/organizations/rbac_groups

Erstellt eine RBAC-Gruppe im Claude Enterprise-Tenant. Über die API erstellte Gruppen haben den Quelltyp "direct".

RBAC-Gruppen auflisten
beta.organization.rbac_groups.list(**kwargs) -> SyncPageCursor[BetaRBACGroup]
GET/v1/organizations/rbac_groups

Listet RBAC-Gruppen im Claude Enterprise-Tenant auf.

RBAC-Gruppe abrufen
beta.organization.rbac_groups.retrieve(rbac_group_id) -> BetaRBACGroup
GET/v1/organizations/rbac_groups/{rbac_group_id}

Ruft eine RBAC-Gruppe anhand ihrer ID ab.

RBAC-Gruppe aktualisieren
beta.organization.rbac_groups.update(rbac_group_id, **kwargs) -> BetaRBACGroup
POST/v1/organizations/rbac_groups/{rbac_group_id}

Aktualisiert den Namen einer RBAC-Gruppe. Von einem Identitätsanbieter bereitgestellte Gruppen (Quelltyp "scim") können nicht über die API geändert werden, solange eine Organisation im Tenant SCIM-Provisionierung verwendet.

RBAC-Gruppe löschen
beta.organization.rbac_groups.delete(rbac_group_id) -> RBACGroupDeleteResponse
DELETE/v1/organizations/rbac_groups/{rbac_group_id}

Löscht eine RBAC-Gruppe. Von einem Identitätsanbieter bereitgestellte Gruppen (Quelltyp "scim") können nicht über die API gelöscht werden, solange eine Organisation im Tenant SCIM-Provisionierung verwendet.

BetaOrganisationRBAC-GruppenMitglieder

Mitglieder einer RBAC-Gruppe auflisten
beta.organization.rbac_groups.members.list(rbac_group_id, **kwargs) -> SyncPageCursor[BetaRBACGroupMember]
GET/v1/organizations/rbac_groups/{rbac_group_id}/members

Listet die Mitglieder einer RBAC-Gruppe auf.

Mitglied zu RBAC-Gruppe hinzufügen
beta.organization.rbac_groups.members.add(rbac_group_id, **kwargs) -> BetaRBACGroupMember
POST/v1/organizations/rbac_groups/{rbac_group_id}/members

Fügt einen Benutzer zu einer RBAC-Gruppe hinzu. Die Mitgliedschaft in Gruppen, die von einem Identitätsanbieter bereitgestellt werden (Quelltyp "scim"), kann nicht über die API geändert werden, solange eine Organisation im Tenant SCIM-Provisioning verwendet.

Mitglied aus RBAC-Gruppe entfernen
beta.organization.rbac_groups.members.remove(user_id, **kwargs) -> MemberRemoveResponse
DELETE/v1/organizations/rbac_groups/{rbac_group_id}/members/{user_id}

Entfernt einen Benutzer aus einer RBAC-Gruppe. Die Mitgliedschaft in Gruppen, die von einem Identitätsanbieter bereitgestellt werden (Quelltyp "scim"), kann nicht über die API geändert werden, solange eine Organisation im Tenant SCIM-Provisioning verwendet.

BetaOrganisationRBAC-Rollen

RBAC-Rollen auflisten
beta.organization.rbac_roles.list(**kwargs) -> SyncPageCursor[BetaRBACRole]
GET/v1/organizations/rbac_roles

Listet RBAC-Rollen in der Organisation auf.

RBAC-Rolle abrufen
beta.organization.rbac_roles.retrieve(rbac_role_id) -> BetaRBACRole
GET/v1/organizations/rbac_roles/{rbac_role_id}

Ruft eine RBAC-Rolle anhand ihrer ID ab.

BetaOrganisationRBAC-RollenBerechtigungen

Berechtigungen einer RBAC-Rolle auflisten
beta.organization.rbac_roles.permissions.list(rbac_role_id, **kwargs) -> SyncPageCursor[BetaRBACRolePermission]
GET/v1/organizations/rbac_roles/{rbac_role_id}/permissions

Listet die Berechtigungen auf, die eine RBAC-Rolle gewährt.

BetaOrganisationPlugins

Plugin erstellen
beta.organization.plugins.create(**kwargs) -> BetaPlugin
POST/v1/organizations/plugins

Erstellt ein Plugin im Besitz der Organisation und seine erste Version, indem die Dateien der Version hochgeladen werden.

Plugin abrufen
beta.organization.plugins.retrieve(plugin_id, **kwargs) -> BetaPlugin
GET/v1/organizations/plugins/{plugin_id}

Ruft ein Plugin anhand seiner ID ab.

Plugin aktualisieren
beta.organization.plugins.update(plugin_id, **kwargs) -> BetaPlugin
POST/v1/organizations/plugins/{plugin_id}

Ändere, welche gespeicherte Version eines organisationseigenen Plugins an Mitglieder ausgeliefert wird, zum Beispiel um zu einer früheren zurückzukehren. Dadurch wird die ausgelieferte Version fixiert: Spätere Uploads werden gespeichert, ändern aber nicht mehr, was ausgeliefert wird, und die Fixierung kann derzeit nicht rückgängig gemacht werden, weder hier noch in claude.ai.

Plugins auflisten
beta.organization.plugins.list(**kwargs) -> SyncPageCursor[BetaPlugin]
GET/v1/organizations/plugins

Listet die unter der Organisation erstellten Plugins auf, die neuesten zuerst: diejenigen in den eigenen Plugin-Marketplaces der Organisation und diejenigen in den persönlichen Plugin-Marketplaces der Mitglieder.

Plugin löschen
beta.organization.plugins.delete(plugin_id, **kwargs) -> BetaDeletedPlugin
DELETE/v1/organizations/plugins/{plugin_id}

Löscht ein Plugin und jede seiner Versionen dauerhaft, genau so, als würde ein Administrator es in claude.ai löschen. Das Plugin kann der Organisation oder einem Mitglied gehören, auch einem Mitglied, das die Organisation inzwischen verlassen hat.

BetaOrganisationPluginsVersionen

Plugin-Version erstellen
beta.organization.plugins.versions.create(plugin_id, **kwargs) -> BetaPluginVersion
POST/v1/organizations/plugins/{plugin_id}/versions

Fügt einem organisationseigenen Plugin eine Version hinzu, indem die Dateien der neuen Version hochgeladen werden; sie wird zur an Mitglieder ausgelieferten Version, sofern die ausgelieferte Version des Plugins nicht fixiert wurde.

Plugin-Versionen auflisten
beta.organization.plugins.versions.list(plugin_id, **kwargs) -> SyncPageCursor[BetaPluginVersion]
GET/v1/organizations/plugins/{plugin_id}/versions

Listet die Versionen eines Plugins auf, die neuesten zuerst.

Plugin-Version abrufen
beta.organization.plugins.versions.retrieve(version, **kwargs) -> BetaPluginVersion
GET/v1/organizations/plugins/{plugin_id}/versions/{version}

Ruft eine Version eines Plugins anhand ihrer ID oder die neueste Version des Plugins ab.

Archiv einer Plugin-Version herunterladen
beta.organization.plugins.versions.download(version, **kwargs) -> BinaryResponseContent
GET/v1/organizations/plugins/{plugin_id}/versions/{version}/content

Lädt das .zip-Archiv einer Version genau so herunter, wie es gespeichert ist. Jeder Download eines Plugins aus dem persönlichen Plugin-Marketplace eines Mitglieds wird im Aktivitäts-Feed der Compliance API protokolliert.

BetaOrganisationPluginsInstallationseinstellungen

Plugin-Installationseinstellungen auflisten
beta.organization.plugins.installation_settings.list(plugin_id, **kwargs) -> SyncPageCursor[BetaPluginInstallationSetting]
GET/v1/organizations/plugins/{plugin_id}/installation_settings

Listet die Installationseinstellungen eines organisationseigenen Plugins auf, die angeben, für welche Mitglieder es bestimmt ist, die zuletzt erstellten zuerst.

Plugin-Installationseinstellung festlegen
beta.organization.plugins.installation_settings.set(target, **kwargs) -> BetaPluginInstallationSetting
POST/v1/organizations/plugins/{plugin_id}/installation_settings/{target}

Legt die Installationseinstellung eines organisationseigenen Plugins für die gesamte Organisation oder für eine RBAC-Gruppe fest oder ändert sie.

Plugin-Installationseinstellung entfernen
beta.organization.plugins.installation_settings.remove(target, **kwargs) -> BetaDeletedPluginInstallationSetting
DELETE/v1/organizations/plugins/{plugin_id}/installation_settings/{target}

Entfernt die eigene Installationseinstellung eines organisationseigenen Plugins für die gesamte Organisation oder für eine RBAC-Gruppe.

BetaOrganisationPluginsFreigaben

Plugin-Freigaben auflisten
beta.organization.plugins.shares.list(plugin_id, **kwargs) -> SyncPageCursor[BetaPluginShare]
GET/v1/organizations/plugins/{plugin_id}/shares

Listet die Freigaben auf, die der Eigentümer eines mitgliedseigenen Plugins erteilt hat – für jedes Mitglied der Organisation, für eine RBAC-Gruppe oder für ein einzelnes Mitglied –, die zuletzt erteilten zuerst.

BetaOrganisationPlugin-Marketplaces

Plugin-Marketplaces auflisten
beta.organization.plugin_marketplaces.list(**kwargs) -> SyncPageCursor[BetaPluginMarketplace]
GET/v1/organizations/plugin_marketplaces

Listet die Plugin-Marketplaces auf, in denen sich Plugins befinden, die neuesten zuerst: die eigenen der Organisation und die persönlichen ihrer Mitglieder.

Plugin-Marketplace abrufen
beta.organization.plugin_marketplaces.retrieve(marketplace_id, **kwargs) -> BetaPluginMarketplace
GET/v1/organizations/plugin_marketplaces/{marketplace_id}

Ruft einen Plugin-Marketplace anhand seiner ID ab.

Plugin-Marketplace aktualisieren
beta.organization.plugin_marketplaces.update(marketplace_id, **kwargs) -> BetaPluginMarketplace
POST/v1/organizations/plugin_marketplaces/{marketplace_id}

Legt die Standard-Installationseinstellung eines der eigenen Plugin-Marketplaces der Organisation fest. Jedes darin enthaltene Plugin ohne eigene Einstellung erhält diesen Standard als seine organisationsweite Einstellung, einschließlich später hinzugefügter Plugins.

Plugin-Marketplace-Repository validieren
beta.organization.plugin_marketplaces.validate_repository(**kwargs) -> BetaPluginMarketplaceValidationReport
POST/v1/organizations/plugin_marketplaces/validate_repository

Prüft, ob ein Plugin-Marketplace in einem öffentlichen GitHub-Repository in claude.ai synchronisiert werden würde, ohne ihn zu verbinden oder zu speichern.

Plugin-Marketplace-Archiv validieren
beta.organization.plugin_marketplaces.validate_archive(**kwargs) -> BetaPluginMarketplaceValidationReport
POST/v1/organizations/plugin_marketplaces/validate_archive

Prüft, ob ein Plugin-Marketplace, hochgeladen als .zip-Datei des Marketplace-Verzeichnisses, in claude.ai synchronisiert werden würde, ohne ihn zu verbinden oder zu speichern.