Claude Platform Docs

Lister les espaces de travail d'un compte de service

$client->beta->organization->serviceAccounts->workspaces->list(string serviceAccountID, ?int limit, ?string page, ?list<AnthropicBeta> betas): PageCursor<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 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
serviceAccountID: string

ID of the service account.

limit?:optional int

Number of results per page.

default20
page?:optional string

Opaque cursor from a previous response's next_page.

betas?:optional list<AnthropicBeta>

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

Returns
class ServiceAccountWorkspaceMember { $type = 'service_account_workspace_member'; $createdByActorID; $implicit; /* 3 more */ }
"service_account_workspace_member" type
?string createdByActorID

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

?bool implicit

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.

string serviceAccountID

Tagged service account ID (svac_...).

string workspaceID

Tagged workspace ID (wrkspc_...).

WorkspaceRole workspaceRole

Role of the service account in this workspace. Service accounts cannot hold the workspace_billing role.

Lister les espaces de travail d'un compte de service
<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

$client = new Client(apiKey: 'my-anthropic-api-key');

$page = $client->beta->organization->serviceAccounts->workspaces->list(
  'service_account_id',
  limit: 1,
  page: 'page',
  betas: [AnthropicBeta::MESSAGE_BATCHES_2024_09_24],
);

var_dump($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"
}