Buat Anggota Workspace Akun Layanan

$ ant beta:organization:workspaces:service-accounts add

POST/v1/organizations/workspaces/{workspace_id}/service_accounts

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

Menambahkan service account ke workspace dengan workspace_role yang diberikan.

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

Parameters

--workspace-id: string

Path param: ID of the workspace.

--service-account-id: string

Body param: Tagged service account ID to add.

--workspace-role: "workspace_admin" or "workspace_developer" or "workspace_restricted_developer" or "workspace_user"

Body param: Role to assign to the service account in this workspace.

--beta: optional array of AnthropicBeta

Header param: Optional header to specify the beta version(s) you want to use.

Returns

beta_service_account_workspace_member: object{ created_by_actor_id, implicit, service_account_id, 3 more }

created_by_actor_id: string

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

implicit: boolean

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_...).

type: "service_account_workspace_member"

workspace_id: string

Tagged workspace ID (wrkspc_...).

workspace_role: "workspace_admin" or "workspace_billing" or "workspace_developer" or 2 more

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

ant beta:organization:workspaces:service-accounts add \
  --api-key my-anthropic-api-key \
  --workspace-id workspace_id \
  --service-account-id service_account_id \
  --workspace-role workspace_admin

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"
}

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"
}