Buat Anggota Workspace Akun Layanan

$client->organization->workspaces->serviceAccounts->add(string workspaceID, string serviceAccountID, NoBillingWorkspaceRole workspaceRole): 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 akun layanan ke workspace dengan workspace_role yang diberikan.

Peran tersebut 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 workspace_user implisit dari workspace default; menambahkannya secara eksplisit akan menetapkan peran yang dipilih. Jika akun layanan sudah menjadi anggota eksplisit dari workspace, workspace_role-nya diganti dengan nilai yang diberikan di sini. Workspace yang diarsipkan mengembalikan 400. Akun layanan yang diarsipkan tidak dapat ditambahkan dan akan ditolak.

Parameters

workspaceID: string⁠Path

ID of the workspace.

serviceAccountID: string

Tagged service account ID to add.

workspaceRole: NoBillingWorkspaceRole

Role to assign to the service account in this workspace.

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';

use Anthropic\Client;
use Anthropic\Organization\Workspaces\NoBillingWorkspaceRole;

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

$serviceAccountWorkspaceMember = $client
  ->organization
  ->workspaces
  ->serviceAccounts
  ->add(
  'workspace_id',
  serviceAccountID: 'service_account_id',
  workspaceRole: NoBillingWorkspaceRole::WORKSPACE_ADMIN,
);

var_dump($serviceAccountWorkspaceMember);

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