Claude Platform Docs

Lister les espaces de travail d'un compte de service

$ ant beta:organization:service-accounts:workspaces list
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 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 non valide. 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 depuis la première page pour récupérer.

Parameters
--service-account-id: string

Path param: ID of the service account.

--limit: optional number

Query param: Number of results per page.

maximum100
minimum1
--page: optional string

Query param: Opaque cursor from a previous response's next_page.

--beta: optional array of AnthropicBeta

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

Returns
BetaServiceAccountWorkspaceMemberListResponse: object{ data, next_page }
data: array of BetaServiceAccountWorkspaceMember { created_by_actor_id, implicit, service_account_id, 3 more }
created_by_actor_id: string

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

implicit: boolean

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

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

Lister les espaces de travail d'un compte de service
ant beta:organization:service-accounts:workspaces list \
  --api-key my-anthropic-api-key \
  --service-account-id service_account_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"
}