Daftar Workspace untuk Akun Layanan

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.

Path parameters

service_account_id: string

ID of the service account.

Query parameters

limit: optional number

Number of results per page.

default20

maximum100

minimum1

page: optional string

Opaque cursor from a previous response's next_page.

Headers

"anthropic-beta": optional array of string

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

To use multiple betas, use a comma separated list like beta1,beta2 or specify the header multiple times for each beta.

Returns

data: array of object{ created_by_actor_id, implicit, service_account_id, 3 more }

created_by_actor_id: string or null

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

implicit: boolean or null

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"

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

next_page: string or null

Opaque cursor for the next page, or null if no more results.

Daftar Workspace untuk Akun Layanan

cURL

curl https://api.anthropic.com/v1/organizations/service_accounts/$SERVICE_ACCOUNT_ID/workspaces \
    -H 'anthropic-version: 2023-06-01' \
    -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN"

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