列出服務帳戶

GET/v1/organizations/service_accounts

需要具有 org:admin 範圍的 OAuth 存取權杖，可透過 ant auth login --scope org:admin 或工作負載身分聯合規則取得；不接受 Admin API 金鑰。請參閱使用 Admin API 管理 WIF。

列出呼叫者組織中的服務帳戶。

結果依建立時間排序，最新的在前。使用 limit 和 next_page 游標進行分頁；設定 include_archived=true 以包含已封存的服務帳戶。

Query parameters

include_archived: optional boolean

Include archived resources. Defaults to false.

defaultfalse

limit: optional number

Number of results per page.

default20

minimum1

maximum100

page: optional string

Opaque cursor from a previous response's next_page.

Returns

data: array of ServiceAccount { type: "service_account", id, archived_at, 8 more }

type: "service_account"

defaultservice_account

id: string

Tagged ID of the service account.

archived_at: string or null

If set, this service account is archived.

formatdate-time

archived_by_actor_id: string or null

Tagged ID (user_/svac_) of the actor that archived this service account.

created_at: string

When this service account was created.

formatdate-time

created_by_actor_id: string or null

Tagged ID (user_/svac_) of the actor that created this service account.

description: string or null

Optional free-text description.

name: string

Admin-chosen slug identifier.

organization_role: "admin" or "developer"

Org-level role. A federation rule may only be created or retargeted to grant org:admin scope when this is admin. A rule granting org:admin whose target is later demoted to developer is rejected at token exchange. Rules granting org:admin are managed in the Console.

One of the following:

"admin"

"developer"

updated_at: string

When this service account was last updated.

formatdate-time

updated_by_actor_id: string or null

Tagged ID (user_/svac_) of the actor that last updated this service account.

next_page: string or null

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

列出服務帳戶

curl https://api.anthropic.com/v1/organizations/service_accounts \
    -H 'anthropic-version: 2023-06-01' \
    -H "X-Api-Key: $ANTHROPIC_API_KEY"

Response 200

{
  "data": [
    {
      "id": "svac_01SDCCSbTxrXDpWc1phhtcfK",
      "archived_at": "2019-12-27T18:11:19.117Z",
      "archived_by_actor_id": "archived_by_actor_id",
      "created_at": "2024-10-30T23:58:27.427722Z",
      "created_by_actor_id": "created_by_actor_id",
      "description": "description",
      "name": "ci-deploy-bot",
      "organization_role": "admin",
      "type": "service_account",
      "updated_at": "2024-10-30T23:58:27.427722Z",
      "updated_by_actor_id": "updated_by_actor_id"
    }
  ],
  "next_page": "next_page"
}

Returns Examples

Response 200

{
  "data": [
    {
      "id": "svac_01SDCCSbTxrXDpWc1phhtcfK",
      "archived_at": "2019-12-27T18:11:19.117Z",
      "archived_by_actor_id": "archived_by_actor_id",
      "created_at": "2024-10-30T23:58:27.427722Z",
      "created_by_actor_id": "created_by_actor_id",
      "description": "description",
      "name": "ci-deploy-bot",
      "organization_role": "admin",
      "type": "service_account",
      "updated_at": "2024-10-30T23:58:27.427722Z",
      "updated_by_actor_id": "updated_by_actor_id"
    }
  ],
  "next_page": "next_page"
}