Daftar Workspace untuk Akun Layanan

$client->beta->organization->serviceAccounts->workspaces->list(string serviceAccountID, ?int limit, ?string page, ?list<AnthropicBeta> betas): PageCursor<ServiceAccountWorkspaceMember>

GET/v1/organizations/service_accounts/{service_account_id}/workspaces

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

Menampilkan daftar workspace tempat akun layanan menjadi anggota.

Setiap entri menyertakan workspace_role akun layanan di workspace tersebut. Gunakan limit dan kursor next_page untuk paginasi. Ketika akun layanan tidak memiliki keanggotaan workspace default yang eksplisit, keanggotaan implisit (implicit: true) dikembalikan sebagai entri pertama pada halaman pertama; dengan limit=1 halaman pertama dapat mengembalikan hingga 2 entri (entri implisit ditambah satu keanggotaan eksplisit) sehingga kursor paginasi dapat diturunkan. Keanggotaan hanya dikembalikan selama akun layanan aktif. Tanpa kursor page, akun layanan yang diarsipkan mengembalikan daftar kosong. Kursor page yang tidak cocok dengan keanggotaan aktif mengembalikan kesalahan invalid-request 400. Kursor berhenti cocok ketika keanggotaan dihapus, workspace dihapus, atau akun layanan diarsipkan. Mulai ulang paginasi dari halaman pertama untuk memulihkan.

Parameters

serviceAccountID: string

ID of the service account.

limit?:optional int

Number of results per page.

default20

page?:optional string

Opaque cursor from a previous response's next_page.

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.

Daftar Workspace untuk Akun Layanan

<?php

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

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

$page = $client->beta->organization->serviceAccounts->workspaces->list(
  'service_account_id',
  limit: 1,
  page: 'page',
  betas: [AnthropicBeta::MESSAGE_BATCHES_2024_09_24],
);

var_dump($page);

Response 200

{
  "data": [
    {
      "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"
    }
  ],
  "next_page": "next_page"
}

Returns Examples

Response 200

{
  "data": [
    {
      "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"
    }
  ],
  "next_page": "next_page"
}