Список рабочих пространств сервисного аккаунта

GET/v1/organizations/service_accounts/{service_account_id}/workspaces

Требуется токен доступа OAuth с областью org:admin, полученный через ant auth login --scope org:admin или правило федерации удостоверений рабочих нагрузок; ключи Admin API не принимаются. См. Управление WIF с помощью Admin API.

Вывести список рабочих пространств, участником которых является сервисный аккаунт.

Каждая запись содержит workspace_role сервисного аккаунта в этом рабочем пространстве. Используйте limit и курсор next_page для постраничной навигации. Если у сервисного аккаунта нет явного членства в рабочем пространстве по умолчанию, неявное (implicit: true) членство возвращается первой записью на первой странице; при limit=1 первая страница может вернуть до 2 записей (неявная запись плюс одно явное членство), чтобы можно было получить курсор постраничной навигации. Членства возвращаются только пока сервисный аккаунт активен. Без курсора page для архивированного сервисного аккаунта возвращается пустой список. Курсор page, не соответствующий активному членству, возвращает ошибку 400 invalid-request. Курсор перестаёт соответствовать, когда членство удалено, рабочее пространство удалено или сервисный аккаунт архивирован. Для восстановления начните постраничную навигацию с первой страницы.

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.

Список рабочих пространств сервисного аккаунта

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