Claude Platform Docs

Daftar Workspace untuk Akun Layanan

organization.service_accounts.workspaces.list(service_account_id, **kwargs) -> SyncPageCursor[ServiceAccountWorkspaceMember]
GET/v1/organizations/service_accounts/{service_account_id}/workspaces

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.

Daftar workspace tempat akun layanan menjadi anggota.

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

Parameters
service_account_id: str⁠Path parameter

ID of the service account.

limit: Optional[int]⁠Query parameter

Number of results per page.

default20
minimum1
maximum100
page: Optional[str]⁠Query parameter

Opaque cursor from a previous response's next_page.

Returns
class ServiceAccountWorkspaceMember: type: "service_account_workspace_member"; created_by_actor_id; implicit; ... # 3 more
type: Literal["service_account_workspace_member"]
defaultservice_account_workspace_member
created_by_actor_id: Optional[str]

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

implicit: Optional[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: str

Tagged service account ID (svac_...).

workspace_id: str

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"
Daftar Workspace untuk Akun Layanan
import os
from anthropic import Anthropic

client = Anthropic(
    api_key=os.environ.get(
        "ANTHROPIC_API_KEY"
    ),  # This is the default and can be omitted
)
page = client.organization.service_accounts.workspaces.list(
    service_account_id="service_account_id",
)
page = page.data[0]
print(page.created_by_actor_id)
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"
}