Listar contas de serviço

GET/v1/organizations/service_accounts

Requer um token de acesso OAuth com o escopo org:admin, obtido via ant auth login --scope org:admin ou por uma regra de workload identity federation (federação de identidade de carga de trabalho); chaves de Admin API não são aceitas. Consulte Gerenciar WIF com a Admin API.

Liste as contas de serviço na organização do chamador.

Os resultados são ordenados por data de criação, mais recentes primeiro. Use limit e o cursor next_page para paginar; defina include_archived=true para incluir contas de serviço arquivadas.

Query parameters

include_archived: optional boolean

Include archived resources. Defaults to false.

defaultfalse

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 ServiceAccount { id, archived_at, archived_by_actor_id, 8 more }

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"

type: "service_account"

defaultservice_account

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.

Listar contas de serviço

cURL

curl https://api.anthropic.com/v1/organizations/service_accounts \
    -H 'anthropic-version: 2023-06-01' \
    -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN"

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