Claude Platform Docs

Lister les espaces de travail d'un compte de service

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

Nécessite un jeton d'accès OAuth avec la portée org:admin, obtenu via ant auth login --scope org:admin ou une règle de workload identity federation (fédération d'identité de charge de travail) ; les clés Admin API ne sont pas acceptées. Consultez Gérer WIF avec l'Admin API.

Listez les espaces de travail dont un compte de service est membre.

Chaque entrée inclut le workspace_role du compte de service dans cet espace de travail. Utilisez limit et le curseur next_page pour paginer. Lorsque le compte de service n'a pas d'appartenance explicite à l'espace de travail par défaut, l'appartenance implicite (implicit: true) est renvoyée comme première entrée de la première page ; avec limit=1, la première page peut renvoyer jusqu'à 2 entrées (l'entrée implicite plus une appartenance explicite) afin qu'un curseur de pagination puisse être dérivé. Les appartenances ne sont renvoyées que tant que le compte de service est actif. Sans curseur page, un compte de service archivé renvoie une liste vide. Un curseur page qui ne correspond pas à une appartenance active renvoie une erreur 400 de requête invalide. Un curseur cesse de correspondre lorsque l'appartenance est supprimée, que l'espace de travail est supprimé ou que le compte de service est archivé. Reprenez la pagination à partir de la première page pour rétablir la situation.

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"
Lister les espaces de travail d'un compte de service
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"
}