Buat Anggota Workspace Akun Layanan

$client->beta->organization->workspaces->serviceAccounts->add(string workspaceID, string serviceAccountID, NoBillingWorkspaceRole workspaceRole, ?list<AnthropicBeta> betas): ServiceAccountWorkspaceMember

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

workspaceID: string

ID of the workspace.

serviceAccountID: string

Tagged service account ID to add.

workspaceRole: NoBillingWorkspaceRole

Role to assign to the service account in this workspace.

betas?:optional list<AnthropicBeta>

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

Returns

class ServiceAccountWorkspaceMember { $type = 'service_account_workspace_member'; $createdByActorID; $implicit; /* 3 more */ }

"service_account_workspace_member" type

?string createdByActorID

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

?bool implicit

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.

string serviceAccountID

Tagged service account ID (svac_...).

string workspaceID

Tagged workspace ID (wrkspc_...).

WorkspaceRole workspaceRole

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

Buat Anggota Workspace Akun Layanan

<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

$client = new Client(apiKey: 'my-anthropic-api-key');

$betaServiceAccountWorkspaceMember = $client
  ->beta
  ->organization
  ->workspaces
  ->serviceAccounts
  ->add(
  'workspace_id',
  serviceAccountID: 'service_account_id',
  workspaceRole: NoBillingWorkspaceRole::WORKSPACE_ADMIN,
  betas: [AnthropicBeta::MESSAGE_BATCHES_2024_09_24],
);

var_dump($betaServiceAccountWorkspaceMember);

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