Claude Platform Docs

베타

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

베타모델

모델 목록 조회
beta.models.list(**kwargs) -> SyncPage[BetaModelInfo]
GET/v1/models

사용 가능한 모델을 나열합니다.

모델 조회
beta.models.retrieve(model_id, **kwargs) -> BetaModelInfo
GET/v1/models/{model_id}

특정 모델을 조회합니다.

베타메시지

메시지 생성
beta.messages.create(**kwargs) -> BetaMessage
POST/v1/messages

텍스트 및/또는 이미지 콘텐츠가 포함된 구조화된 입력 메시지 목록을 전송하면 모델이 대화의 다음 메시지를 생성합니다.

메시지의 토큰 수 계산
beta.messages.count_tokens(**kwargs) -> BetaMessageTokensCount
POST/v1/messages/count_tokens

메시지의 토큰 수를 계산합니다.

베타메시지배치

메시지 배치 생성
beta.messages.batches.create(**kwargs) -> BetaMessageBatch
POST/v1/messages/batches

메시지 생성 요청의 배치를 전송합니다.

메시지 배치 조회
beta.messages.batches.retrieve(message_batch_id, **kwargs) -> BetaMessageBatch
GET/v1/messages/batches/{message_batch_id}

이 엔드포인트는 멱등성(idempotent)을 가지며 메시지 배치 완료 여부를 폴링하는 데 사용할 수 있습니다. 메시지 배치의 결과에 액세스하려면 응답의 results_url 필드로 요청을 보내세요.

메시지 배치 목록 조회
beta.messages.batches.list(**kwargs) -> SyncPage[BetaMessageBatch]
GET/v1/messages/batches

워크스페이스 내의 모든 메시지 배치를 나열합니다. 가장 최근에 생성된 배치가 먼저 반환됩니다.

메시지 배치 취소
beta.messages.batches.cancel(message_batch_id, **kwargs) -> BetaMessageBatch
POST/v1/messages/batches/{message_batch_id}/cancel

배치는 처리가 종료되기 전까지 언제든지 취소할 수 있습니다. 취소가 시작되면 배치는 canceling 상태로 전환되며, 이 시점에서 시스템은 취소를 최종 완료하기 전에 진행 중이며 중단할 수 없는 요청을 먼저 완료할 수 있습니다.

메시지 배치 삭제
beta.messages.batches.delete(message_batch_id, **kwargs) -> BetaDeletedMessageBatch
DELETE/v1/messages/batches/{message_batch_id}

메시지 배치를 삭제합니다.

메시지 배치 결과 조회
beta.messages.batches.results(message_batch_id, **kwargs) -> BetaMessageBatchIndividualResponse
GET/v1/messages/batches/{message_batch_id}/results

메시지 배치의 결과를 .jsonl 파일로 스트리밍합니다.

베타에이전트

에이전트 생성
beta.agents.create(**kwargs) -> BetaManagedAgentsAgent
POST/v1/agents
에이전트 목록 조회
beta.agents.list(**kwargs) -> SyncPageCursor[BetaManagedAgentsAgent]
GET/v1/agents
에이전트 조회
beta.agents.retrieve(agent_id, **kwargs) -> BetaManagedAgentsAgent
GET/v1/agents/{agent_id}
에이전트 업데이트
beta.agents.update(agent_id, **kwargs) -> BetaManagedAgentsAgent
POST/v1/agents/{agent_id}
에이전트 보관
beta.agents.archive(agent_id, **kwargs) -> BetaManagedAgentsAgent
POST/v1/agents/{agent_id}/archive

베타에이전트버전

에이전트 버전 목록 조회
beta.agents.versions.list(agent_id, **kwargs) -> SyncPageCursor[BetaManagedAgentsAgent]
GET/v1/agents/{agent_id}/versions

베타환경

환경 생성
beta.environments.create(**kwargs) -> BetaEnvironment
POST/v1/environments

지정된 구성으로 새 환경을 생성합니다.

환경 목록 조회
beta.environments.list(**kwargs) -> SyncPageCursor[BetaEnvironment]
GET/v1/environments

페이지네이션을 지원하는 환경 목록을 조회합니다.

환경 조회
beta.environments.retrieve(environment_id, **kwargs) -> BetaEnvironment
GET/v1/environments/{environment_id}

ID로 특정 환경을 조회합니다.

환경 업데이트
beta.environments.update(environment_id, **kwargs) -> BetaEnvironment
POST/v1/environments/{environment_id}

기존 환경의 구성을 업데이트합니다.

환경 삭제
beta.environments.delete(environment_id, **kwargs) -> BetaEnvironmentDeleteResponse
DELETE/v1/environments/{environment_id}

ID로 환경을 삭제합니다. 삭제 확인을 반환합니다.

환경 보관
beta.environments.archive(environment_id, **kwargs) -> BetaEnvironment
POST/v1/environments/{environment_id}/archive

ID로 환경을 보관합니다. 보관된 환경은 새 세션을 생성하는 데 사용할 수 없습니다.

베타환경작업

작업 항목 조회
beta.environments.work.retrieve(work_id, **kwargs) -> BetaSelfHostedWork
GET/v1/environments/{environment_id}/work/{work_id}

참고: 이 엔드포인트는 자체 호스팅 샌드박스 환경에서 세션을 오케스트레이션하기 위해 SDK 및 CLI에서 제공하는 사전 빌드된 환경 워커에 의해 자동으로 호출됩니다. 참조용으로 여기에 포함되어 있으며, 직접 호출할 필요는 없습니다.

작업 폴링
beta.environments.work.poll(environment_id, **kwargs) -> BetaSelfHostedWork
GET/v1/environments/{environment_id}/work/poll

참고: 이 엔드포인트는 자체 호스팅 샌드박스 환경에서 세션을 오케스트레이션하기 위해 SDK 및 CLI에서 제공하는 사전 빌드된 환경 워커에 의해 자동으로 호출됩니다. 참조용으로 여기에 포함되어 있으며, 직접 호출할 필요는 없습니다.

작업 확인
beta.environments.work.ack(work_id, **kwargs) -> BetaSelfHostedWork
POST/v1/environments/{environment_id}/work/{work_id}/ack

참고: 이러한 엔드포인트는 자체 호스팅 샌드박스 환경과의 세션을 오케스트레이션하기 위해 SDK 및 CLI에서 제공되는 사전 빌드된 환경 워커에 의해 자동으로 호출됩니다. 참조용으로 여기에 포함되어 있으며, 직접 호출할 필요는 없습니다.

하트비트 기록
beta.environments.work.heartbeat(work_id, **kwargs) -> BetaSelfHostedWorkHeartbeatResponse
POST/v1/environments/{environment_id}/work/{work_id}/heartbeat

참고: 이러한 엔드포인트는 자체 호스팅 샌드박스 환경과의 세션을 오케스트레이션하기 위해 SDK 및 CLI에서 제공되는 사전 빌드된 환경 워커에 의해 자동으로 호출됩니다. 참조용으로 여기에 포함되어 있으며, 직접 호출할 필요는 없습니다.

작업 중지
beta.environments.work.stop(work_id, **kwargs) -> BetaSelfHostedWork
POST/v1/environments/{environment_id}/work/{work_id}/stop

참고: 이러한 엔드포인트는 자체 호스팅 샌드박스 환경과의 세션을 오케스트레이션하기 위해 SDK 및 CLI에서 제공되는 사전 빌드된 환경 워커에 의해 자동으로 호출됩니다. 참조용으로 여기에 포함되어 있으며, 직접 호출할 필요는 없습니다.

작업 항목 나열
beta.environments.work.list(environment_id, **kwargs) -> SyncPageCursor[BetaSelfHostedWork]
GET/v1/environments/{environment_id}/work

참고: 이러한 엔드포인트는 자체 호스팅 샌드박스 환경과의 세션을 오케스트레이션하기 위해 SDK 및 CLI에서 제공되는 사전 빌드된 환경 워커에 의해 자동으로 호출됩니다. 참조용으로 여기에 포함되어 있으며, 직접 호출할 필요는 없습니다.

작업 항목 업데이트
beta.environments.work.update(work_id, **kwargs) -> BetaSelfHostedWork
POST/v1/environments/{environment_id}/work/{work_id}

참고: 이러한 엔드포인트는 자체 호스팅 샌드박스 환경과의 세션을 오케스트레이션하기 위해 SDK 및 CLI에서 제공되는 사전 빌드된 환경 워커에 의해 자동으로 호출됩니다. 참조용으로 여기에 포함되어 있으며, 직접 호출할 필요는 없습니다.

큐 통계 가져오기
beta.environments.work.stats(environment_id, **kwargs) -> BetaSelfHostedWorkQueueStats
GET/v1/environments/{environment_id}/work/stats

환경의 작업 큐에 대한 통계를 가져옵니다.

베타세션

세션 생성
beta.sessions.create(**kwargs) -> BetaManagedAgentsSession
POST/v1/sessions
세션 나열
beta.sessions.list(**kwargs) -> SyncBidirectionalPageCursor[BetaManagedAgentsSession]
GET/v1/sessions
세션 가져오기
beta.sessions.retrieve(session_id, **kwargs) -> BetaManagedAgentsSession
GET/v1/sessions/{session_id}
세션 업데이트
beta.sessions.update(session_id, **kwargs) -> BetaManagedAgentsSession
POST/v1/sessions/{session_id}
세션 삭제
beta.sessions.delete(session_id, **kwargs) -> BetaManagedAgentsDeletedSession
DELETE/v1/sessions/{session_id}
세션 보관
beta.sessions.archive(session_id, **kwargs) -> BetaManagedAgentsSession
POST/v1/sessions/{session_id}/archive

베타세션이벤트

이벤트 나열
beta.sessions.events.list(session_id, **kwargs) -> SyncPageCursor[BetaManagedAgentsSessionEvent]
GET/v1/sessions/{session_id}/events
이벤트 전송
beta.sessions.events.send(session_id, **kwargs) -> BetaManagedAgentsSendSessionEvents
POST/v1/sessions/{session_id}/events
이벤트 스트리밍
beta.sessions.events.stream(session_id, **kwargs) -> BetaManagedAgentsStreamSessionEvents
GET/v1/sessions/{session_id}/events/stream

베타세션리소스

세션 리소스 추가
beta.sessions.resources.add(session_id, **kwargs) -> BetaManagedAgentsFileResource
POST/v1/sessions/{session_id}/resources
세션 리소스 나열
beta.sessions.resources.list(session_id, **kwargs) -> SyncPageCursor[BetaManagedAgentsSessionResource]
GET/v1/sessions/{session_id}/resources
세션 리소스 가져오기
beta.sessions.resources.retrieve(resource_id, **kwargs) -> ResourceRetrieveResponse
GET/v1/sessions/{session_id}/resources/{resource_id}
세션 리소스 업데이트
beta.sessions.resources.update(resource_id, **kwargs) -> ResourceUpdateResponse
POST/v1/sessions/{session_id}/resources/{resource_id}
세션 리소스 삭제
beta.sessions.resources.delete(resource_id, **kwargs) -> BetaManagedAgentsDeleteSessionResource
DELETE/v1/sessions/{session_id}/resources/{resource_id}

베타세션스레드

세션 스레드 나열
beta.sessions.threads.list(session_id, **kwargs) -> SyncPageCursor[BetaManagedAgentsSessionThread]
GET/v1/sessions/{session_id}/threads
세션 스레드 가져오기
beta.sessions.threads.retrieve(thread_id, **kwargs) -> BetaManagedAgentsSessionThread
GET/v1/sessions/{session_id}/threads/{thread_id}
세션 스레드 보관
beta.sessions.threads.archive(thread_id, **kwargs) -> BetaManagedAgentsSessionThread
POST/v1/sessions/{session_id}/threads/{thread_id}/archive

베타세션스레드이벤트

세션 스레드 이벤트 나열
beta.sessions.threads.events.list(thread_id, **kwargs) -> SyncPageCursor[BetaManagedAgentsSessionEvent]
GET/v1/sessions/{session_id}/threads/{thread_id}/events
세션 스레드 이벤트 스트리밍
beta.sessions.threads.events.stream(thread_id, **kwargs) -> BetaManagedAgentsStreamSessionThreadEvents
GET/v1/sessions/{session_id}/threads/{thread_id}/stream

베타배포

배포 생성
beta.deployments.create(**kwargs) -> BetaManagedAgentsDeployment
POST/v1/deployments
배포 나열
beta.deployments.list(**kwargs) -> SyncPageCursor[BetaManagedAgentsDeployment]
GET/v1/deployments
배포 가져오기
beta.deployments.retrieve(deployment_id, **kwargs) -> BetaManagedAgentsDeployment
GET/v1/deployments/{deployment_id}
배포 업데이트
beta.deployments.update(deployment_id, **kwargs) -> BetaManagedAgentsDeployment
POST/v1/deployments/{deployment_id}
배포 보관
beta.deployments.archive(deployment_id, **kwargs) -> BetaManagedAgentsDeployment
POST/v1/deployments/{deployment_id}/archive
지금 배포 실행
beta.deployments.run(deployment_id, **kwargs) -> BetaManagedAgentsDeploymentRun
POST/v1/deployments/{deployment_id}/run
배포 일시 중지
beta.deployments.pause(deployment_id, **kwargs) -> BetaManagedAgentsDeployment
POST/v1/deployments/{deployment_id}/pause
배포 일시 중지 해제
beta.deployments.unpause(deployment_id, **kwargs) -> BetaManagedAgentsDeployment
POST/v1/deployments/{deployment_id}/unpause

베타배포 실행

배포 실행 목록 조회
beta.deployment_runs.list(**kwargs) -> SyncPageCursor[BetaManagedAgentsDeploymentRun]
GET/v1/deployment_runs
배포 실행 조회
beta.deployment_runs.retrieve(deployment_run_id, **kwargs) -> BetaManagedAgentsDeploymentRun
GET/v1/deployment_runs/{deployment_run_id}

베타볼트

볼트 생성
beta.vaults.create(**kwargs) -> BetaManagedAgentsVault
POST/v1/vaults
볼트 목록 조회
beta.vaults.list(**kwargs) -> SyncPageCursor[BetaManagedAgentsVault]
GET/v1/vaults
볼트 조회
beta.vaults.retrieve(vault_id, **kwargs) -> BetaManagedAgentsVault
GET/v1/vaults/{vault_id}
볼트 업데이트
beta.vaults.update(vault_id, **kwargs) -> BetaManagedAgentsVault
POST/v1/vaults/{vault_id}
볼트 삭제
beta.vaults.delete(vault_id, **kwargs) -> BetaManagedAgentsDeletedVault
DELETE/v1/vaults/{vault_id}
볼트 보관
beta.vaults.archive(vault_id, **kwargs) -> BetaManagedAgentsVault
POST/v1/vaults/{vault_id}/archive

베타볼트자격 증명

자격 증명 생성
beta.vaults.credentials.create(vault_id, **kwargs) -> BetaManagedAgentsCredential
POST/v1/vaults/{vault_id}/credentials
자격 증명 목록 조회
beta.vaults.credentials.list(vault_id, **kwargs) -> SyncPageCursor[BetaManagedAgentsCredential]
GET/v1/vaults/{vault_id}/credentials
자격 증명 조회
beta.vaults.credentials.retrieve(credential_id, **kwargs) -> BetaManagedAgentsCredential
GET/v1/vaults/{vault_id}/credentials/{credential_id}
자격 증명 업데이트
beta.vaults.credentials.update(credential_id, **kwargs) -> BetaManagedAgentsCredential
POST/v1/vaults/{vault_id}/credentials/{credential_id}
자격 증명 삭제
beta.vaults.credentials.delete(credential_id, **kwargs) -> BetaManagedAgentsDeletedCredential
DELETE/v1/vaults/{vault_id}/credentials/{credential_id}
자격 증명 보관
beta.vaults.credentials.archive(credential_id, **kwargs) -> BetaManagedAgentsCredential
POST/v1/vaults/{vault_id}/credentials/{credential_id}/archive
자격 증명 검증
beta.vaults.credentials.mcp_oauth_validate(credential_id, **kwargs) -> BetaManagedAgentsCredentialValidation
POST/v1/vaults/{vault_id}/credentials/{credential_id}/mcp_oauth_validate

베타메모리 스토어

메모리 스토어 생성
beta.memory_stores.create(**kwargs) -> BetaManagedAgentsMemoryStore
POST/v1/memory_stores
메모리 스토어 목록 조회
beta.memory_stores.list(**kwargs) -> SyncPageCursor[BetaManagedAgentsMemoryStore]
GET/v1/memory_stores
메모리 스토어 조회
beta.memory_stores.retrieve(memory_store_id, **kwargs) -> BetaManagedAgentsMemoryStore
GET/v1/memory_stores/{memory_store_id}
메모리 스토어 업데이트
beta.memory_stores.update(memory_store_id, **kwargs) -> BetaManagedAgentsMemoryStore
POST/v1/memory_stores/{memory_store_id}
메모리 스토어 삭제
beta.memory_stores.delete(memory_store_id, **kwargs) -> BetaManagedAgentsDeletedMemoryStore
DELETE/v1/memory_stores/{memory_store_id}
메모리 스토어 보관
beta.memory_stores.archive(memory_store_id, **kwargs) -> BetaManagedAgentsMemoryStore
POST/v1/memory_stores/{memory_store_id}/archive

베타메모리 스토어메모리

메모리 생성
beta.memory_stores.memories.create(memory_store_id, **kwargs) -> BetaManagedAgentsMemory
POST/v1/memory_stores/{memory_store_id}/memories
메모리 목록 조회
beta.memory_stores.memories.list(memory_store_id, **kwargs) -> SyncPageCursor[BetaManagedAgentsMemoryListItem]
GET/v1/memory_stores/{memory_store_id}/memories
메모리 조회
beta.memory_stores.memories.retrieve(memory_id, **kwargs) -> BetaManagedAgentsMemory
GET/v1/memory_stores/{memory_store_id}/memories/{memory_id}
메모리 업데이트
beta.memory_stores.memories.update(memory_id, **kwargs) -> BetaManagedAgentsMemory
POST/v1/memory_stores/{memory_store_id}/memories/{memory_id}
메모리 삭제
beta.memory_stores.memories.delete(memory_id, **kwargs) -> BetaManagedAgentsDeletedMemory
DELETE/v1/memory_stores/{memory_store_id}/memories/{memory_id}

베타메모리 스토어메모리 버전

메모리 버전 목록 조회
beta.memory_stores.memory_versions.list(memory_store_id, **kwargs) -> SyncPageCursor[BetaManagedAgentsMemoryVersion]
GET/v1/memory_stores/{memory_store_id}/memory_versions
메모리 버전 조회
beta.memory_stores.memory_versions.retrieve(memory_version_id, **kwargs) -> BetaManagedAgentsMemoryVersion
GET/v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id}
메모리 버전 삭제 처리
beta.memory_stores.memory_versions.redact(memory_version_id, **kwargs) -> BetaManagedAgentsMemoryVersion
POST/v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id}/redact

베타파일

파일 업로드
beta.files.upload(**kwargs) -> BetaFileMetadata
POST/v1/files
파일 목록 조회
beta.files.list(**kwargs) -> SyncPageCursor[BetaFileMetadata]
GET/v1/files
파일 다운로드
beta.files.download(file_id, **kwargs) -> BinaryResponseContent
GET/v1/files/{file_id}/content
파일 메타데이터 조회
beta.files.retrieve_metadata(file_id, **kwargs) -> BetaFileMetadata
GET/v1/files/{file_id}
파일 삭제
beta.files.delete(file_id, **kwargs) -> BetaDeletedFile
DELETE/v1/files/{file_id}

베타스킬

스킬 생성
beta.skills.create(**kwargs) -> BetaSkill
POST/v1/skills
스킬 목록 조회
beta.skills.list(**kwargs) -> SyncPageCursor[BetaSkill]
GET/v1/skills
스킬 조회
beta.skills.retrieve(skill_id, **kwargs) -> BetaSkill
GET/v1/skills/{skill_id}
스킬 삭제
beta.skills.delete(skill_id, **kwargs) -> BetaDeletedSkill
DELETE/v1/skills/{skill_id}

베타스킬버전

스킬 버전 생성
beta.skills.versions.create(skill_id, **kwargs) -> BetaSkillVersion
POST/v1/skills/{skill_id}/versions
스킬 버전 목록 조회
beta.skills.versions.list(skill_id, **kwargs) -> SyncPageCursor[BetaSkillVersion]
GET/v1/skills/{skill_id}/versions
스킬 버전 콘텐츠 다운로드
beta.skills.versions.download(version, **kwargs) -> BinaryResponseContent
GET/v1/skills/{skill_id}/versions/{version}/content

스킬 버전의 콘텐츠를 zip 아카이브로 다운로드합니다.

스킬 버전 조회
beta.skills.versions.retrieve(version, **kwargs) -> BetaSkillVersion
GET/v1/skills/{skill_id}/versions/{version}
스킬 버전 삭제
beta.skills.versions.delete(version, **kwargs) -> BetaDeletedSkillVersion
DELETE/v1/skills/{skill_id}/versions/{version}

베타사용자 프로필

사용자 프로필 생성
beta.user_profiles.create(**kwargs) -> BetaUserProfile
POST/v1/user_profiles
사용자 프로필 목록 조회
beta.user_profiles.list(**kwargs) -> SyncPageCursor[BetaUserProfile]
GET/v1/user_profiles
사용자 프로필 조회
beta.user_profiles.retrieve(user_profile_id, **kwargs) -> BetaUserProfile
GET/v1/user_profiles/{user_profile_id}
사용자 프로필 업데이트
beta.user_profiles.update(user_profile_id, **kwargs) -> BetaUserProfile
POST/v1/user_profiles/{user_profile_id}
등록 URL 생성
beta.user_profiles.create_enrollment_url(user_profile_id, **kwargs) -> BetaUserProfileEnrollmentURL
POST/v1/user_profiles/{user_profile_id}/enrollment_url

베타Dream

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

과거 세션을 사용하여 메모리 저장소의 재구성된 버전을 생성하는 비동기 작업을 시작하고, 결과를 폴링할 수 있는 드림을 반환받습니다.

Dream 목록 조회
beta.dreams.list(**kwargs) -> SyncPageCursor[BetaDream]
GET/v1/dreams

워크스페이스의 드림 목록을 최신순으로 조회합니다.

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

ID로 드림을 조회하여 상태, 출력 메모리 저장소, 토큰 사용량을 확인합니다.

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

pending 또는 running 상태의 드림을 중지합니다.

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

completed, failed 또는 canceled 상태의 드림을 기본 드림 목록에서 숨깁니다.

베타터널

터널 생성
beta.tunnels.create(**kwargs) -> BetaTunnel
POST/v1/tunnels

Tunnels API는 리서치 프리뷰 단계입니다. anthropic-beta: mcp-tunnels-2026-06-22 헤더가 필요하며, 지원 중단 기간 없이 변경될 수 있습니다. 이 API는 /v1/organizations/tunnels의 Admin API 엔드포인트를 대체하며, 해당 엔드포인트는 마이그레이션 기간 동안 계속 사용할 수 있습니다.

터널 조회
beta.tunnels.retrieve(tunnel_id, **kwargs) -> BetaTunnel
GET/v1/tunnels/{tunnel_id}

Tunnels API는 리서치 프리뷰 단계입니다. anthropic-beta: mcp-tunnels-2026-06-22 헤더가 필요하며, 지원 중단 기간 없이 변경될 수 있습니다. 이 API는 /v1/organizations/tunnels의 Admin API 엔드포인트를 대체하며, 해당 엔드포인트는 마이그레이션 기간 동안 계속 사용할 수 있습니다.

터널 목록 조회
beta.tunnels.list(**kwargs) -> SyncPageCursor[BetaTunnel]
GET/v1/tunnels

Tunnels API는 리서치 프리뷰 단계입니다. anthropic-beta: mcp-tunnels-2026-06-22 헤더가 필요하며, 지원 중단 기간 없이 변경될 수 있습니다. 이 API는 /v1/organizations/tunnels의 Admin API 엔드포인트를 대체하며, 해당 엔드포인트는 마이그레이션 기간 동안 계속 사용할 수 있습니다.

터널 보관
beta.tunnels.archive(tunnel_id, **kwargs) -> BetaTunnel
POST/v1/tunnels/{tunnel_id}/archive

Tunnels API는 리서치 프리뷰 단계입니다. anthropic-beta: mcp-tunnels-2026-06-22 헤더가 필요하며, 지원 중단 기간 없이 변경될 수 있습니다. 이 API는 /v1/organizations/tunnels의 Admin API 엔드포인트를 대체하며, 해당 엔드포인트는 마이그레이션 기간 동안 계속 사용할 수 있습니다.

터널 토큰 공개
beta.tunnels.reveal_token(tunnel_id, **kwargs) -> BetaTunnelToken
POST/v1/tunnels/{tunnel_id}/reveal_token

Tunnels API는 리서치 프리뷰 단계입니다. anthropic-beta: mcp-tunnels-2026-06-22 헤더가 필요하며, 지원 중단 기간 없이 변경될 수 있습니다. 이 API는 /v1/organizations/tunnels의 Admin API 엔드포인트를 대체하며, 해당 엔드포인트는 마이그레이션 기간 동안 계속 사용할 수 있습니다.

터널 토큰 교체
beta.tunnels.rotate_token(tunnel_id, **kwargs) -> BetaTunnelToken
POST/v1/tunnels/{tunnel_id}/rotate_token

Tunnels API는 리서치 프리뷰 단계입니다. anthropic-beta: mcp-tunnels-2026-06-22 헤더가 필요하며, 지원 중단 기간 없이 변경될 수 있습니다. 이 API는 /v1/organizations/tunnels의 Admin API 엔드포인트를 대체하며, 해당 엔드포인트는 마이그레이션 기간 동안 계속 사용할 수 있습니다.

베타터널인증서

터널 인증서 생성
beta.tunnels.certificates.create(tunnel_id, **kwargs) -> BetaTunnelCertificate
POST/v1/tunnels/{tunnel_id}/certificates

Tunnels API는 리서치 프리뷰 단계입니다. anthropic-beta: mcp-tunnels-2026-06-22 헤더가 필요하며, 지원 중단 기간 없이 변경될 수 있습니다. 이 API는 /v1/organizations/tunnels의 Admin API 엔드포인트를 대체하며, 해당 엔드포인트는 마이그레이션 기간 동안 계속 사용할 수 있습니다.

터널 인증서 조회
beta.tunnels.certificates.retrieve(certificate_id, **kwargs) -> BetaTunnelCertificate
GET/v1/tunnels/{tunnel_id}/certificates/{certificate_id}

Tunnels API는 리서치 프리뷰 단계입니다. anthropic-beta: mcp-tunnels-2026-06-22 헤더가 필요하며, 지원 중단 기간 없이 변경될 수 있습니다. 이 API는 /v1/organizations/tunnels의 Admin API 엔드포인트를 대체하며, 해당 엔드포인트는 마이그레이션 기간 동안 계속 사용할 수 있습니다.

터널 인증서 목록 조회
beta.tunnels.certificates.list(tunnel_id, **kwargs) -> SyncPageCursor[BetaTunnelCertificate]
GET/v1/tunnels/{tunnel_id}/certificates

Tunnels API는 리서치 프리뷰 단계입니다. anthropic-beta: mcp-tunnels-2026-06-22 헤더가 필요하며, 지원 중단 기간 없이 변경될 수 있습니다. 이 API는 /v1/organizations/tunnels의 Admin API 엔드포인트를 대체하며, 해당 엔드포인트는 마이그레이션 기간 동안 계속 사용할 수 있습니다.

터널 인증서 보관
beta.tunnels.certificates.archive(certificate_id, **kwargs) -> BetaTunnelCertificate
POST/v1/tunnels/{tunnel_id}/certificates/{certificate_id}/archive

Tunnels API는 리서치 프리뷰 단계입니다. anthropic-beta: mcp-tunnels-2026-06-22 헤더가 필요하며, 지원 중단 기간 없이 변경될 수 있습니다. 이 API는 /v1/organizations/tunnels의 Admin API 엔드포인트를 대체하며, 해당 엔드포인트는 마이그레이션 기간 동안 계속 사용할 수 있습니다.

베타조직

현재 조직 조회
beta.organization.retrieve() -> BetaOrganization
GET/v1/organizations/me

인증된 API 키와 연결된 조직에 대한 정보를 조회합니다.

베타조직API 키

API 키 목록 조회
beta.organization.api_keys.list(**kwargs) -> SyncPage[BetaAPIKey]
GET/v1/organizations/api_keys
API 키 조회 (Admin API)
beta.organization.api_keys.retrieve(api_key_id) -> BetaAPIKey
GET/v1/organizations/api_keys/{api_key_id}

조직 내 단일 API 키에 대한 정보를 ID로 조회합니다. 이 Admin API 엔드포인트는 Admin API 키가 필요하고, 프로그래밍 방식의 키 관리를 위한 것이며, 키의 비밀 값은 절대 반환하지 않습니다. 자신의 API 키를 보거나 생성하려면 Claude Console의 API 키로 이동하세요.

API 키 업데이트
beta.organization.api_keys.update(api_key_id, **kwargs) -> BetaAPIKey
POST/v1/organizations/api_keys/{api_key_id}

베타조직외부 키

외부 키 생성
beta.organization.external_keys.create(**kwargs) -> BetaExternalKey
POST/v1/organizations/external_keys

호출자의 조직이 소유하는 외부 키 구성을 생성합니다.

외부 키 목록 조회
beta.organization.external_keys.list(**kwargs) -> SyncPageCursor[BetaExternalKey]
GET/v1/organizations/external_keys

호출자의 조직에 있는 외부 키 구성을 나열합니다.

외부 키 조회
beta.organization.external_keys.retrieve(external_key_id) -> BetaExternalKey
GET/v1/organizations/external_keys/{external_key_id}

호출자의 조직에 있는 단일 외부 키 구성을 ID로 조회합니다.

외부 키 업데이트
beta.organization.external_keys.update(external_key_id, **kwargs) -> BetaExternalKey
POST/v1/organizations/external_keys/{external_key_id}

외부 키 구성을 부분적으로 업데이트합니다. 생략된 필드는 변경되지 않습니다.

외부 키 삭제
beta.organization.external_keys.delete(external_key_id) -> ExternalKeyDeleteResponse
DELETE/v1/organizations/external_keys/{external_key_id}

외부 키 구성을 삭제합니다.

외부 키 검증
beta.organization.external_keys.validate(external_key_id) -> ExternalKeyValidateResponse
POST/v1/organizations/external_keys/{external_key_id}/validate

고객의 KMS를 대상으로 외부 키 구성을 검증합니다.

베타조직페더레이션발급자

페더레이션 발급자 생성
beta.organization.federation.issuers.create(**kwargs) -> BetaFederationIssuer
POST/v1/organizations/federation_issuers

org:admin 범위가 있는 OAuth 액세스 토큰이 필요합니다. 이 토큰은 ant auth login --scope org:admin 또는 워크로드 ID 페더레이션 규칙에서 얻을 수 있으며, Admin API 키는 허용되지 않습니다. Admin API로 WIF 관리를 참조하세요.

페더레이션 발급자 목록 조회
beta.organization.federation.issuers.list(**kwargs) -> SyncPageCursor[BetaFederationIssuer]
GET/v1/organizations/federation_issuers

org:admin 범위가 있는 OAuth 액세스 토큰이 필요합니다. 이 토큰은 ant auth login --scope org:admin 또는 워크로드 ID 페더레이션 규칙에서 얻을 수 있으며, Admin API 키는 허용되지 않습니다. Admin API로 WIF 관리를 참조하세요.

페더레이션 발급자 조회
beta.organization.federation.issuers.retrieve(federation_issuer_id, **kwargs) -> BetaFederationIssuer
GET/v1/organizations/federation_issuers/{federation_issuer_id}

org:admin 범위가 있는 OAuth 액세스 토큰이 필요합니다. 이 토큰은 ant auth login --scope org:admin 또는 워크로드 ID 페더레이션 규칙에서 얻을 수 있으며, Admin API 키는 허용되지 않습니다. Admin API로 WIF 관리를 참조하세요.

페더레이션 발급자 업데이트
beta.organization.federation.issuers.update(federation_issuer_id, **kwargs) -> BetaFederationIssuer
POST/v1/organizations/federation_issuers/{federation_issuer_id}

org:admin 범위가 있는 OAuth 액세스 토큰이 필요합니다. 이 토큰은 ant auth login --scope org:admin 또는 워크로드 ID 페더레이션 규칙에서 얻을 수 있으며, Admin API 키는 허용되지 않습니다. Admin API로 WIF 관리를 참조하세요.

페더레이션 발급자 보관
beta.organization.federation.issuers.archive(federation_issuer_id, **kwargs) -> BetaFederationIssuer
POST/v1/organizations/federation_issuers/{federation_issuer_id}/archive

org:admin 범위가 있는 OAuth 액세스 토큰이 필요합니다. 이 토큰은 ant auth login --scope org:admin 또는 워크로드 ID 페더레이션 규칙에서 얻을 수 있으며, Admin API 키는 허용되지 않습니다. Admin API로 WIF 관리를 참조하세요.

베타조직페더레이션규칙

페더레이션 규칙 생성
beta.organization.federation.rules.create(**kwargs) -> BetaFederationRule
POST/v1/organizations/federation_rules

org:admin 범위가 있는 OAuth 액세스 토큰이 필요합니다. 이 토큰은 ant auth login --scope org:admin 또는 워크로드 ID 페더레이션 규칙에서 얻을 수 있으며, Admin API 키는 허용되지 않습니다. Admin API로 WIF 관리를 참조하세요.

페더레이션 규칙 목록 조회
beta.organization.federation.rules.list(**kwargs) -> SyncPageCursor[BetaFederationRule]
GET/v1/organizations/federation_rules

org:admin 범위가 있는 OAuth 액세스 토큰이 필요합니다. 이 토큰은 ant auth login --scope org:admin 또는 워크로드 ID 페더레이션 규칙에서 얻을 수 있으며, Admin API 키는 허용되지 않습니다. Admin API로 WIF 관리를 참조하세요.

페더레이션 규칙 조회
beta.organization.federation.rules.retrieve(federation_rule_id, **kwargs) -> BetaFederationRule
GET/v1/organizations/federation_rules/{federation_rule_id}

org:admin 범위가 있는 OAuth 액세스 토큰이 필요합니다. 이 토큰은 ant auth login --scope org:admin 또는 워크로드 ID 페더레이션 규칙에서 얻을 수 있으며, Admin API 키는 허용되지 않습니다. Admin API로 WIF 관리를 참조하세요.

페더레이션 규칙 업데이트
beta.organization.federation.rules.update(federation_rule_id, **kwargs) -> BetaFederationRule
POST/v1/organizations/federation_rules/{federation_rule_id}

org:admin 범위가 있는 OAuth 액세스 토큰이 필요합니다. 이 토큰은 ant auth login --scope org:admin 또는 워크로드 ID 페더레이션 규칙에서 얻을 수 있으며, Admin API 키는 허용되지 않습니다. Admin API로 WIF 관리를 참조하세요.

페더레이션 규칙 보관
beta.organization.federation.rules.archive(federation_rule_id, **kwargs) -> BetaFederationRule
POST/v1/organizations/federation_rules/{federation_rule_id}/archive

org:admin 범위가 있는 OAuth 액세스 토큰이 필요합니다. 이 토큰은 ant auth login --scope org:admin 또는 워크로드 ID 페더레이션 규칙에서 얻을 수 있으며, Admin API 키는 허용되지 않습니다. Admin API로 WIF 관리를 참조하세요.

베타조직페더레이션규칙워크스페이스

페더레이션 규칙 워크스페이스 추가
beta.organization.federation.rules.workspaces.add(federation_rule_id, **kwargs) -> BetaFederationRuleWorkspace
POST/v1/organizations/federation_rules/{federation_rule_id}/workspaces

org:admin 범위가 있는 OAuth 액세스 토큰이 필요합니다. 이 토큰은 ant auth login --scope org:admin 또는 워크로드 ID 페더레이션 규칙에서 얻을 수 있으며, Admin API 키는 허용되지 않습니다. Admin API로 WIF 관리를 참조하세요.

페더레이션 규칙 워크스페이스 목록 조회
beta.organization.federation.rules.workspaces.list(federation_rule_id, **kwargs) -> SyncPageCursor[BetaFederationRuleWorkspace]
GET/v1/organizations/federation_rules/{federation_rule_id}/workspaces

org:admin 범위가 있는 OAuth 액세스 토큰이 필요합니다. 이 토큰은 ant auth login --scope org:admin 또는 워크로드 ID 페더레이션 규칙에서 얻을 수 있으며, Admin API 키는 허용되지 않습니다. Admin API로 WIF 관리를 참조하세요.

페더레이션 규칙 워크스페이스 제거
beta.organization.federation.rules.workspaces.remove(workspace_id, **kwargs) -> WorkspaceRemoveResponse
DELETE/v1/organizations/federation_rules/{federation_rule_id}/workspaces/{workspace_id}

org:admin 범위가 있는 OAuth 액세스 토큰이 필요합니다. 이 토큰은 ant auth login --scope org:admin 또는 워크로드 ID 페더레이션 규칙에서 얻을 수 있으며, Admin API 키는 허용되지 않습니다. Admin API로 WIF 관리를 참조하세요.

베타조직초대

초대 생성
beta.organization.invites.create(**kwargs) -> BetaOrganizationInvite
POST/v1/organizations/invites

이메일로 사용자를 조직에 초대합니다.

초대 목록 조회
beta.organization.invites.list(**kwargs) -> SyncPage[BetaOrganizationInvite]
GET/v1/organizations/invites

조직의 초대를 나열합니다.

초대 조회
beta.organization.invites.retrieve(invite_id) -> BetaOrganizationInvite
GET/v1/organizations/invites/{invite_id}

ID로 초대를 조회합니다.

초대 삭제
beta.organization.invites.delete(invite_id) -> InviteDeleteResponse
DELETE/v1/organizations/invites/{invite_id}

대기 중인 초대를 삭제합니다.

베타조직서비스 계정

서비스 계정 생성
beta.organization.service_accounts.create(**kwargs) -> BetaServiceAccount
POST/v1/organizations/service_accounts

org:admin 범위가 있는 OAuth 액세스 토큰이 필요합니다. 이 토큰은 ant auth login --scope org:admin 또는 워크로드 ID 페더레이션 규칙에서 얻을 수 있으며, Admin API 키는 허용되지 않습니다. Admin API로 WIF 관리를 참조하세요.

서비스 계정 목록 조회
beta.organization.service_accounts.list(**kwargs) -> SyncPageCursor[BetaServiceAccount]
GET/v1/organizations/service_accounts

org:admin 범위가 있는 OAuth 액세스 토큰이 필요합니다. 이 토큰은 ant auth login --scope org:admin 또는 워크로드 ID 페더레이션 규칙에서 얻을 수 있으며, Admin API 키는 허용되지 않습니다. Admin API로 WIF 관리를 참조하세요.

서비스 계정 조회
beta.organization.service_accounts.retrieve(service_account_id, **kwargs) -> BetaServiceAccount
GET/v1/organizations/service_accounts/{service_account_id}

org:admin 범위가 있는 OAuth 액세스 토큰이 필요합니다. 이 토큰은 ant auth login --scope org:admin 또는 워크로드 ID 페더레이션 규칙에서 얻을 수 있으며, Admin API 키는 허용되지 않습니다. Admin API로 WIF 관리를 참조하세요.

서비스 계정 업데이트
beta.organization.service_accounts.update(service_account_id, **kwargs) -> BetaServiceAccount
POST/v1/organizations/service_accounts/{service_account_id}

org:admin 범위가 있는 OAuth 액세스 토큰이 필요합니다. 이 토큰은 ant auth login --scope org:admin 또는 워크로드 ID 페더레이션 규칙에서 얻을 수 있으며, Admin API 키는 허용되지 않습니다. Admin API로 WIF 관리를 참조하세요.

서비스 계정 보관
beta.organization.service_accounts.archive(service_account_id, **kwargs) -> BetaServiceAccount
POST/v1/organizations/service_accounts/{service_account_id}/archive

org:admin 범위가 있는 OAuth 액세스 토큰이 필요합니다. 이 토큰은 ant auth login --scope org:admin 또는 워크로드 ID 페더레이션 규칙에서 얻을 수 있으며, Admin API 키는 허용되지 않습니다. Admin API로 WIF 관리를 참조하세요.

베타조직서비스 계정워크스페이스

서비스 계정에 워크스페이스 추가
beta.organization.service_accounts.workspaces.add(service_account_id, **kwargs) -> BetaServiceAccountWorkspaceMember
POST/v1/organizations/service_accounts/{service_account_id}/workspaces

org:admin 범위가 있는 OAuth 액세스 토큰이 필요합니다. 이 토큰은 ant auth login --scope org:admin 또는 워크로드 ID 페더레이션 규칙에서 얻을 수 있으며, Admin API 키는 허용되지 않습니다. Admin API로 WIF 관리를 참조하세요.

서비스 계정의 워크스페이스 목록 조회
beta.organization.service_accounts.workspaces.list(service_account_id, **kwargs) -> SyncPageCursor[BetaServiceAccountWorkspaceMember]
GET/v1/organizations/service_accounts/{service_account_id}/workspaces

org:admin 범위가 있는 OAuth 액세스 토큰이 필요합니다. 이 토큰은 ant auth login --scope org:admin 또는 워크로드 ID 페더레이션 규칙에서 얻을 수 있으며, Admin API 키는 허용되지 않습니다. Admin API로 WIF 관리를 참조하세요.

서비스 계정에서 워크스페이스 제거
beta.organization.service_accounts.workspaces.remove(workspace_id, **kwargs) -> WorkspaceRemoveResponse
DELETE/v1/organizations/service_accounts/{service_account_id}/workspaces/{workspace_id}

org:admin 범위가 있는 OAuth 액세스 토큰이 필요합니다. 이 토큰은 ant auth login --scope org:admin 또는 워크로드 ID 페더레이션 규칙에서 얻을 수 있으며, Admin API 키는 허용되지 않습니다. Admin API로 WIF 관리를 참조하세요.

베타조직사용자

사용자 목록 조회
beta.organization.users.list(**kwargs) -> SyncPage[BetaOrganizationUser]
GET/v1/organizations/users

조직의 멤버를 나열합니다.

사용자 조회
beta.organization.users.retrieve(user_id) -> BetaOrganizationUser
GET/v1/organizations/users/{user_id}

사용자 ID로 조직의 멤버를 조회합니다.

사용자 업데이트
beta.organization.users.update(user_id, **kwargs) -> BetaOrganizationUser
POST/v1/organizations/users/{user_id}

멤버의 조직 역할을 업데이트합니다.

사용자 제거
beta.organization.users.remove(user_id) -> UserRemoveResponse
DELETE/v1/organizations/users/{user_id}

조직에서 멤버를 제거합니다.

베타조직워크스페이스

워크스페이스 목록 조회
beta.organization.workspaces.list(**kwargs) -> SyncPage[BetaWorkspace]
GET/v1/organizations/workspaces
워크스페이스 생성
beta.organization.workspaces.create(**kwargs) -> BetaWorkspace
POST/v1/organizations/workspaces
워크스페이스 조회
beta.organization.workspaces.retrieve(workspace_id) -> BetaWorkspace
GET/v1/organizations/workspaces/{workspace_id}
워크스페이스 업데이트
beta.organization.workspaces.update(workspace_id, **kwargs) -> BetaWorkspace
POST/v1/organizations/workspaces/{workspace_id}
워크스페이스 보관
beta.organization.workspaces.archive(workspace_id) -> BetaWorkspace
POST/v1/organizations/workspaces/{workspace_id}/archive

베타조직워크스페이스속도 제한

워크스페이스 속도 제한 목록 조회
beta.organization.workspaces.rate_limits.list(workspace_id, **kwargs) -> SyncPageCursor[BetaWorkspaceRateLimit]
GET/v1/organizations/workspaces/{workspace_id}/rate_limits

워크스페이스의 속도 제한을 나열합니다.

베타조직워크스페이스멤버

워크스페이스 멤버 목록 조회
beta.organization.workspaces.members.list(workspace_id, **kwargs) -> SyncPage[BetaWorkspaceMember]
GET/v1/organizations/workspaces/{workspace_id}/members
워크스페이스 멤버 생성
beta.organization.workspaces.members.add(workspace_id, **kwargs) -> BetaWorkspaceMember
POST/v1/organizations/workspaces/{workspace_id}/members
워크스페이스 멤버 조회
beta.organization.workspaces.members.retrieve(user_id, **kwargs) -> BetaWorkspaceMember
GET/v1/organizations/workspaces/{workspace_id}/members/{user_id}
워크스페이스 멤버 업데이트
beta.organization.workspaces.members.update(user_id, **kwargs) -> BetaWorkspaceMember
POST/v1/organizations/workspaces/{workspace_id}/members/{user_id}
워크스페이스 멤버 삭제
beta.organization.workspaces.members.remove(user_id, **kwargs) -> MemberRemoveResponse
DELETE/v1/organizations/workspaces/{workspace_id}/members/{user_id}

베타조직워크스페이스서비스 계정

서비스 계정 워크스페이스 멤버 목록 조회
beta.organization.workspaces.service_accounts.list(workspace_id, **kwargs) -> SyncPageCursor[BetaServiceAccountWorkspaceMember]
GET/v1/organizations/workspaces/{workspace_id}/service_accounts

org:admin 범위가 있는 OAuth 액세스 토큰이 필요합니다. 이 토큰은 ant auth login --scope org:admin 또는 워크로드 ID 페더레이션 규칙에서 얻을 수 있으며, Admin API 키는 허용되지 않습니다. Admin API로 WIF 관리를 참조하세요.

서비스 계정 워크스페이스 멤버 생성
beta.organization.workspaces.service_accounts.add(workspace_id, **kwargs) -> BetaServiceAccountWorkspaceMember
POST/v1/organizations/workspaces/{workspace_id}/service_accounts

org:admin 범위가 있는 OAuth 액세스 토큰이 필요합니다. 이 토큰은 ant auth login --scope org:admin 또는 워크로드 ID 페더레이션 규칙에서 얻을 수 있으며, Admin API 키는 허용되지 않습니다. Admin API로 WIF 관리를 참조하세요.

서비스 계정 워크스페이스 멤버 조회
beta.organization.workspaces.service_accounts.retrieve(service_account_id, **kwargs) -> BetaServiceAccountWorkspaceMember
GET/v1/organizations/workspaces/{workspace_id}/service_accounts/{service_account_id}

org:admin 범위가 있는 OAuth 액세스 토큰이 필요합니다. 이 토큰은 ant auth login --scope org:admin 또는 워크로드 ID 페더레이션 규칙에서 얻을 수 있으며, Admin API 키는 허용되지 않습니다. Admin API로 WIF 관리를 참조하세요.

서비스 계정 워크스페이스 멤버 업데이트
beta.organization.workspaces.service_accounts.update(service_account_id, **kwargs) -> BetaServiceAccountWorkspaceMember
POST/v1/organizations/workspaces/{workspace_id}/service_accounts/{service_account_id}

org:admin 범위가 있는 OAuth 액세스 토큰이 필요합니다. 이 토큰은 ant auth login --scope org:admin 또는 워크로드 ID 페더레이션 규칙에서 얻을 수 있으며, Admin API 키는 허용되지 않습니다. Admin API로 WIF 관리를 참조하세요.

서비스 계정 워크스페이스 멤버 삭제
beta.organization.workspaces.service_accounts.remove(service_account_id, **kwargs) -> ServiceAccountRemoveResponse
DELETE/v1/organizations/workspaces/{workspace_id}/service_accounts/{service_account_id}

org:admin 범위가 있는 OAuth 액세스 토큰이 필요합니다. 이 토큰은 ant auth login --scope org:admin 또는 workload identity federation(워크로드 ID 페더레이션) 규칙을 통해 얻을 수 있으며, Admin API 키는 허용되지 않습니다. Admin API로 WIF 관리를 참조하세요.

베타조직속도 제한

조직 속도 제한 목록 조회
beta.organization.rate_limits.list(**kwargs) -> SyncPageCursor[BetaOrganizationRateLimit]
GET/v1/organizations/rate_limits

조직의 Messages API 속도 제한 목록을 조회합니다.

베타조직규정 준수 설정

규정 준수 설정 조회
beta.organization.compliance_settings.retrieve() -> BetaComplianceSettings
GET/v1/organizations/compliance_settings

조직의 Compliance Settings(규정 준수 설정)를 조회합니다.

규정 준수 설정 업데이트
beta.organization.compliance_settings.update(**kwargs) -> BetaComplianceSettings
POST/v1/organizations/compliance_settings

조직의 Compliance Settings를 업데이트합니다.

베타조직분석요약

활동 요약 조회
beta.organization.analytics.summaries.list(**kwargs) -> SyncPageCursor[BetaAnalyticsSingleDayActivitySummary]
GET/v1/organizations/analytics/summaries

지정한 날짜 범위에 대한 조직 전체의 활동 요약을 조회합니다.

베타조직분석사용자

사용자 활동 목록 조회
beta.organization.analytics.users.list(**kwargs) -> SyncPageCursor[BetaAnalyticsUserActivity]
GET/v1/organizations/analytics/users

커서 기반 페이지네이션으로 특정 날짜의 사용자별 활동을 가져옵니다.

베타조직분석앱채팅프로젝트

채팅 프로젝트 사용량 조회
beta.organization.analytics.apps.chat.projects.list(**kwargs) -> SyncPageCursor[BetaAnalyticsProjectActivity]
GET/v1/organizations/analytics/apps/chat/projects

특정 날짜의 프로젝트별 활동을 커서 기반 페이지네이션으로 조회합니다.

베타조직분석커넥터

커넥터 사용량 조회
beta.organization.analytics.connectors.list(**kwargs) -> SyncPageCursor[BetaAnalyticsConnectorActivity]
GET/v1/organizations/analytics/connectors

커서 기반 페이지네이션으로 특정 날짜의 커넥터별 사용량을 가져옵니다.

베타조직분석플러그인

플러그인 사용량 조회
beta.organization.analytics.plugins.list(**kwargs) -> SyncPageCursor[BetaAnalyticsPluginActivity]
GET/v1/organizations/analytics/plugins

페이지네이션으로 특정 날짜의 플러그인별 설치 + 호출 사용량을 가져옵니다.

베타조직분석스킬

스킬 사용량 조회
beta.organization.analytics.skills.list(**kwargs) -> SyncPageCursor[BetaAnalyticsSkillActivity]
GET/v1/organizations/analytics/skills

커서 기반 페이지네이션으로 특정 날짜의 스킬별 사용량을 가져옵니다.

베타조직분석Artifacts

Artifact 활동 조회
beta.organization.analytics.artifacts.list(**kwargs) -> SyncPageCursor[BetaAnalyticsArtifactActivity]
GET/v1/organizations/analytics/artifacts

특정 날짜의 아티팩트 생성 활동을 MIME 유형별로 세분화하여 가져옵니다.

베타조직분석사용량 보고서

시간 경과에 따른 토큰 사용량 조회
beta.organization.analytics.usage_report.list(**kwargs) -> SyncPageCursor[BetaAnalyticsUsageReportTimeBucket]
GET/v1/organizations/analytics/usage_report

날짜 범위에 걸친 시간 경과에 따른 토큰 사용량을 조회합니다.

베타조직분석사용자 사용량 보고서

사용자별 토큰 사용량 조회
beta.organization.analytics.user_usage_report.list(**kwargs) -> SyncPageCursor[BetaAnalyticsUsageUsersItem]
GET/v1/organizations/analytics/user_usage_report

날짜 범위에 걸친 사용자별 토큰 사용량을 조회합니다.

베타조직분석비용 보고서

시간 경과에 따른 비용 조회
beta.organization.analytics.cost_report.list(**kwargs) -> SyncPageCursor[BetaAnalyticsCostReportTimeBucket]
GET/v1/organizations/analytics/cost_report

날짜 범위에 걸친 시간 경과에 따른 USD 비용을 조회합니다.

베타조직분석사용자 비용 보고서

사용자별 비용 조회
beta.organization.analytics.user_cost_report.list(**kwargs) -> SyncPageCursor[BetaAnalyticsCostUsersItem]
GET/v1/organizations/analytics/user_cost_report

날짜 범위에 걸친 사용자별 USD 비용을 조회합니다.

베타조직지출 한도

지출 한도 설정
beta.organization.spend_limits.set(**kwargs) -> BetaSpendLimit
POST/v1/organizations/spend_limits

지출 한도를 설정합니다.

지출 한도 조회
beta.organization.spend_limits.retrieve(spend_limit_id) -> BetaSpendLimit
GET/v1/organizations/spend_limits/{spend_limit_id}

ID로 지출 한도를 조회합니다.

지출 한도 삭제
beta.organization.spend_limits.delete(spend_limit_id) -> SpendLimitDeleteResponse
DELETE/v1/organizations/spend_limits/{spend_limit_id}

지출 한도를 삭제합니다.

지출 한도 목록 조회
beta.organization.spend_limits.list(**kwargs) -> SyncPageCursor[BetaSpendLimit]
GET/v1/organizations/spend_limits

조직의 지출 한도를 나열합니다.

베타조직지출 한도유효

유효 지출 한도 목록 조회
beta.organization.spend_limits.effective.list(**kwargs) -> SyncPageCursor[BetaSpendSummary]
GET/v1/organizations/spend_limits/effective

각 멤버의 유효 지출 한도와 기간 누적 지출액을 나열합니다.

베타조직지출 한도증액 요청

지출 한도 증액 요청 목록 조회
beta.organization.spend_limits.increase_requests.list(**kwargs) -> SyncPageCursor[BetaSpendLimitIncreaseRequest]
GET/v1/organizations/spend_limit_increase_requests

지출 한도 증액 요청 목록을 최신순으로 조회합니다.

지출 한도 증액 요청 조회
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}

지출 한도 증액 요청을 조회합니다.

지출 한도 증액 요청 승인
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

대기 중인 지출 한도 증액 요청을 승인합니다.

지출 한도 증액 요청 거부
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

대기 중인 지출 한도 증액 요청을 거부합니다.

베타조직RBAC 그룹

RBAC 그룹 생성
beta.organization.rbac_groups.create(**kwargs) -> BetaRBACGroup
POST/v1/organizations/rbac_groups

Claude Enterprise 테넌트에 RBAC 그룹을 생성합니다. API를 통해 생성된 그룹의 소스 유형은 "direct"입니다.

RBAC 그룹 목록 조회
beta.organization.rbac_groups.list(**kwargs) -> SyncPageCursor[BetaRBACGroup]
GET/v1/organizations/rbac_groups

Claude Enterprise 테넌트의 RBAC 그룹 목록을 조회합니다.

RBAC 그룹 조회
beta.organization.rbac_groups.retrieve(rbac_group_id) -> BetaRBACGroup
GET/v1/organizations/rbac_groups/{rbac_group_id}

ID로 RBAC 그룹을 조회합니다.

RBAC 그룹 업데이트
beta.organization.rbac_groups.update(rbac_group_id, **kwargs) -> BetaRBACGroup
POST/v1/organizations/rbac_groups/{rbac_group_id}

RBAC 그룹의 이름을 업데이트합니다. 테넌트의 조직이 SCIM 프로비저닝을 사용하는 동안에는 ID 공급자가 프로비저닝한 그룹(소스 유형 "scim")을 API를 통해 수정할 수 없습니다.

RBAC 그룹 삭제
beta.organization.rbac_groups.delete(rbac_group_id) -> RBACGroupDeleteResponse
DELETE/v1/organizations/rbac_groups/{rbac_group_id}

RBAC 그룹을 삭제합니다. 테넌트의 조직이 SCIM 프로비저닝을 사용하는 동안에는 ID 공급자가 프로비저닝한 그룹(소스 유형 "scim")을 API를 통해 삭제할 수 없습니다.

베타조직RBAC 그룹멤버

RBAC 그룹 멤버 목록 조회
beta.organization.rbac_groups.members.list(rbac_group_id, **kwargs) -> SyncPageCursor[BetaRBACGroupMember]
GET/v1/organizations/rbac_groups/{rbac_group_id}/members

RBAC 그룹의 멤버 목록을 조회합니다.

RBAC 그룹 멤버 추가
beta.organization.rbac_groups.members.add(rbac_group_id, **kwargs) -> BetaRBACGroupMember
POST/v1/organizations/rbac_groups/{rbac_group_id}/members

RBAC 그룹에 사용자를 추가합니다. 테넌트의 조직이 SCIM 프로비저닝을 사용하는 동안에는 ID 공급자가 프로비저닝한 그룹(소스 유형 "scim")의 멤버십을 API로 수정할 수 없습니다.

RBAC 그룹 멤버 제거
beta.organization.rbac_groups.members.remove(user_id, **kwargs) -> MemberRemoveResponse
DELETE/v1/organizations/rbac_groups/{rbac_group_id}/members/{user_id}

RBAC 그룹에서 사용자를 제거합니다. 테넌트의 조직이 SCIM 프로비저닝을 사용하는 동안에는 ID 공급자가 프로비저닝한 그룹(소스 유형 "scim")의 멤버십을 API로 수정할 수 없습니다.

베타조직RBAC 역할

RBAC 역할 목록 조회
beta.organization.rbac_roles.list(**kwargs) -> SyncPageCursor[BetaRBACRole]
GET/v1/organizations/rbac_roles

조직의 RBAC 역할 목록을 조회합니다.

RBAC 역할 조회
beta.organization.rbac_roles.retrieve(rbac_role_id) -> BetaRBACRole
GET/v1/organizations/rbac_roles/{rbac_role_id}

ID로 RBAC 역할을 조회합니다.

베타조직RBAC 역할권한

RBAC 역할 권한 목록 조회
beta.organization.rbac_roles.permissions.list(rbac_role_id, **kwargs) -> SyncPageCursor[BetaRBACRolePermission]
GET/v1/organizations/rbac_roles/{rbac_role_id}/permissions

RBAC 역할이 부여하는 권한 목록을 조회합니다.

베타조직플러그인

플러그인 생성
beta.organization.plugins.create(**kwargs) -> BetaPlugin
POST/v1/organizations/plugins

버전의 파일을 업로드하여 조직 소유 플러그인과 그 첫 번째 버전을 생성합니다.

플러그인 조회
beta.organization.plugins.retrieve(plugin_id, **kwargs) -> BetaPlugin
GET/v1/organizations/plugins/{plugin_id}

ID로 플러그인을 조회합니다.

플러그인 업데이트
beta.organization.plugins.update(plugin_id, **kwargs) -> BetaPlugin
POST/v1/organizations/plugins/{plugin_id}

조직 소유 플러그인의 저장된 버전 중 구성원에게 제공할 버전을 변경합니다. 예를 들어 이전 버전으로 롤백할 때 사용합니다. 이 작업은 제공되는 버전을 고정(pin)합니다. 이후 업로드되는 버전은 저장되지만 더 이상 제공되는 버전을 변경하지 않으며, 고정은 현재 여기서나 claude.ai에서 취소할 수 없습니다.

플러그인 목록 조회
beta.organization.plugins.list(**kwargs) -> SyncPageCursor[BetaPlugin]
GET/v1/organizations/plugins

조직에서 생성된 플러그인을 최신순으로 나열합니다. 조직 자체의 플러그인 마켓플레이스에 있는 플러그인과 구성원의 개인 플러그인 마켓플레이스에 있는 플러그인이 모두 포함됩니다.

플러그인 삭제
beta.organization.plugins.delete(plugin_id, **kwargs) -> BetaDeletedPlugin
DELETE/v1/organizations/plugins/{plugin_id}

관리자가 claude.ai에서 삭제할 때와 똑같이 플러그인과 그 플러그인이 보유한 모든 버전을 영구적으로 삭제합니다. 플러그인은 조직 소유일 수도 있고, 이후 조직을 떠난 구성원을 포함한 구성원 소유일 수도 있습니다.

베타조직플러그인버전

플러그인 버전 생성
beta.organization.plugins.versions.create(plugin_id, **kwargs) -> BetaPluginVersion
POST/v1/organizations/plugins/{plugin_id}/versions

새 버전의 파일을 업로드하여 조직 소유 플러그인에 버전을 추가합니다. 플러그인의 제공 버전이 고정되지 않은 한, 추가된 버전이 구성원에게 제공되는 버전이 됩니다.

플러그인 버전 목록 조회
beta.organization.plugins.versions.list(plugin_id, **kwargs) -> SyncPageCursor[BetaPluginVersion]
GET/v1/organizations/plugins/{plugin_id}/versions

플러그인의 버전을 최신순으로 나열합니다.

플러그인 버전 조회
beta.organization.plugins.versions.retrieve(version, **kwargs) -> BetaPluginVersion
GET/v1/organizations/plugins/{plugin_id}/versions/{version}

ID로 플러그인의 특정 버전을 조회하거나 플러그인의 최신 버전을 조회합니다.

플러그인 버전 아카이브 다운로드
beta.organization.plugins.versions.download(version, **kwargs) -> BinaryResponseContent
GET/v1/organizations/plugins/{plugin_id}/versions/{version}/content

특정 버전의 .zip 아카이브를 저장된 그대로 다운로드합니다. 구성원의 개인 플러그인 마켓플레이스에 있는 플러그인을 다운로드할 때마다 Compliance API 활동 피드에 기록됩니다.

베타조직플러그인설치 설정

플러그인 설치 설정 목록 조회
beta.organization.plugins.installation_settings.list(plugin_id, **kwargs) -> SyncPageCursor[BetaPluginInstallationSetting]
GET/v1/organizations/plugins/{plugin_id}/installation_settings

조직 소유 플러그인의 설치 설정을 가장 최근에 생성된 순서로 나열합니다. 설치 설정은 플러그인이 어떤 구성원을 위한 것인지를 나타냅니다.

플러그인 설치 설정 지정
beta.organization.plugins.installation_settings.set(target, **kwargs) -> BetaPluginInstallationSetting
POST/v1/organizations/plugins/{plugin_id}/installation_settings/{target}

조직 전체 또는 하나의 RBAC 그룹에 대한 조직 소유 플러그인의 설치 설정을 지정하거나 변경합니다.

플러그인 설치 설정 제거
beta.organization.plugins.installation_settings.remove(target, **kwargs) -> BetaDeletedPluginInstallationSetting
DELETE/v1/organizations/plugins/{plugin_id}/installation_settings/{target}

조직 전체 또는 하나의 RBAC 그룹에 대한 조직 소유 플러그인 자체의 설치 설정을 제거합니다.

베타조직플러그인공유

플러그인 공유 목록 조회
beta.organization.plugins.shares.list(plugin_id, **kwargs) -> SyncPageCursor[BetaPluginShare]
GET/v1/organizations/plugins/{plugin_id}/shares

구성원 소유 플러그인의 소유자가 조직의 모든 구성원, RBAC 그룹 또는 한 명의 구성원에게 부여한 공유를 가장 최근에 부여된 순서로 나열합니다.

베타조직플러그인 마켓플레이스

플러그인 마켓플레이스 목록 조회
beta.organization.plugin_marketplaces.list(**kwargs) -> SyncPageCursor[BetaPluginMarketplace]
GET/v1/organizations/plugin_marketplaces

플러그인이 속한 플러그인 마켓플레이스를 최신순으로 나열합니다. 조직 자체의 마켓플레이스와 구성원의 개인 마켓플레이스가 모두 포함됩니다.

플러그인 마켓플레이스 조회
beta.organization.plugin_marketplaces.retrieve(marketplace_id, **kwargs) -> BetaPluginMarketplace
GET/v1/organizations/plugin_marketplaces/{marketplace_id}

ID로 플러그인 마켓플레이스를 조회합니다.

플러그인 마켓플레이스 업데이트
beta.organization.plugin_marketplaces.update(marketplace_id, **kwargs) -> BetaPluginMarketplace
POST/v1/organizations/plugin_marketplaces/{marketplace_id}

조직 자체 플러그인 마켓플레이스 중 하나의 기본 설치 설정을 지정합니다. 해당 마켓플레이스에서 자체 설정이 없는 모든 플러그인은 나중에 추가되는 플러그인을 포함하여 이 기본값을 조직 전체 설정으로 갖게 됩니다.

플러그인 마켓플레이스 리포지토리 검증
beta.organization.plugin_marketplaces.validate_repository(**kwargs) -> BetaPluginMarketplaceValidationReport
POST/v1/organizations/plugin_marketplaces/validate_repository

공개 GitHub 리포지토리에 있는 플러그인 마켓플레이스가 claude.ai로 동기화될 수 있는지 연결하거나 저장하지 않고 확인합니다.

플러그인 마켓플레이스 아카이브 검증
beta.organization.plugin_marketplaces.validate_archive(**kwargs) -> BetaPluginMarketplaceValidationReport
POST/v1/organizations/plugin_marketplaces/validate_archive

마켓플레이스 디렉터리의 .zip으로 업로드된 플러그인 마켓플레이스가 claude.ai로 동기화될 수 있는지 연결하거나 저장하지 않고 확인합니다.