Claude Platform Docs

Buat Anggota Workspace Akun Layanan

organization.workspaces.service_accounts.add(workspace_id, **kwargs) -> ServiceAccountWorkspaceMember
POST/v1/organizations/workspaces/{workspace_id}/service_accounts

Memerlukan token akses OAuth dengan scope org:admin, dari ant auth login --scope org:admin atau aturan workload identity federation; kunci Admin API tidak diterima. Lihat Mengelola WIF dengan Admin API.

Tambahkan akun layanan ke workspace dengan workspace_role yang diberikan.

Peran menentukan apa yang dapat dilakukan akun layanan di workspace dan izin cakupan workspace mana yang dapat diberikan kepadanya saat melakukan autentikasi melalui federasi. Setiap akun layanan sudah menjadi anggota implisit workspace_user di workspace default; menambahkannya secara eksplisit menetapkan peran yang dipilih. Jika akun layanan sudah menjadi anggota eksplisit workspace, workspace_role-nya diganti dengan nilai yang diberikan di sini. Workspace yang diarsipkan mengembalikan 400. Akun layanan yang diarsipkan tidak dapat ditambahkan dan ditolak.

Parameters
workspace_id: String⁠Path parameter

ID of the workspace.

service_account_id: String

Tagged service account ID to add.

workspace_role: NoBillingWorkspaceRole

Role to assign to the service account in this workspace.

One of the following:
:workspace_admin
:workspace_developer
:workspace_restricted_developer
:workspace_user
Returns
class ServiceAccountWorkspaceMember { type: :service_account_workspace_member, created_by_actor_id, implicit, 3 more }
type: :service_account_workspace_member
created_by_actor_id: String

Tagged ID (user_.../svac_...) of the actor who created this membership.

implicit: bool

True when this is the implicit default-workspace membership every service account has when no explicit membership exists. Implicit memberships have role workspace_user and cannot be removed.

service_account_id: String

Tagged service account ID (svac_...).

workspace_id: String

Tagged workspace ID (wrkspc_...).

workspace_role: WorkspaceRole

Role of the service account in this workspace. Service accounts cannot hold the workspace_billing role.

One of the following:
:workspace_admin
:workspace_billing
:workspace_developer
:workspace_restricted_developer
:workspace_user
Buat Anggota Workspace Akun Layanan
require "anthropic"

anthropic = Anthropic::Client.new(api_key: "my-anthropic-api-key")

service_account_workspace_member = anthropic.organization.workspaces.service_accounts.add(
  "workspace_id",
  service_account_id: "service_account_id",
  workspace_role: :workspace_admin
)

puts(service_account_workspace_member)
Returns Examples
Response 200
{
  "created_by_actor_id": "created_by_actor_id",
  "implicit": true,
  "service_account_id": "service_account_id",
  "type": "service_account_workspace_member",
  "workspace_id": "workspace_id",
  "workspace_role": "workspace_admin"
}