Claude Platform Docs

Lister les espaces de travail d'un compte de service

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.

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.

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