Listar contas de serviço organizacional

OBTER /api/v1/organizations/{id}/service-accounts

Autenticação do portador

Lista contas de serviço ao cliente com escopo organizacional. Exige ORG_ADMIN ou ORG_MEMBER (somente leitura).

parâmetros de caminho

id string Obrigatório

ID da organização

parâmetros de query

limit inteiro

Tamanho da página (padrão 50, máximo 200)
cursor string

Definir cursor a partir do próximo_cursor de uma resposta anterior

Respostas

406

aplicação/json

aplicação/json aplicação/vnd.agent-engine-2026-09-20-preview+json

Versão de API não permitida ou malformada, uma operação indisponível no contrato publicado selecionado ou uma representação inaceitável (incluindo parâmetros de tipo de mídia não suportados ou SSE excluído). Falhas existentes de autenticação, autorização e limite de taxa têm precedência.
Ocultar atributos de resposta Mostrar atributos de resposta objeto
- badRequestDetail objeto
  
  Detalhes de validação opcionais definidos pelo esquema de erro padrão; Os erros de negociação da API não emitem este campo.
  
  Ocultar atributo ruimRequestDetail Mostrar atributo ruimRequestDetail objeto
  
  Campos array[objeto]
  
  Campos com falhas de validação.
  
  Ocultar atributos de campos Mostrar atributos dos campos objeto
  
  Um campo e sua falha de validação.
  
  Descrição string Obrigatório
  
  Falha na validação legível por humanos.
  
  Campo string Obrigatório
  
  Nome ou caminho do campo de solicitação inválido .
- detalhe string Obrigatório
  
  Detalhes de erro legíveis por humanos.
- Erro inteiro Obrigatório
  
  HTTP status code.
- Código de erro string Obrigatório
  
  Código de erro legível por máquina.
- Parâmetros array[string]
  
  Solicitar nomes de parâmetros associados ao erro; omitido quando nenhum se aplica.
- Razão string Obrigatório
  
  Frase de razão do status HTTP.
Ocultar atributos de resposta Mostrar atributos de resposta objeto
- badRequestDetail objeto
  
  Detalhes de validação opcionais definidos pelo esquema de erro padrão; Os erros de negociação da API não emitem este campo.
  
  Ocultar atributo ruimRequestDetail Mostrar atributo ruimRequestDetail objeto
  
  Campos array[objeto]
  
  Campos com falhas de validação.
  
  Ocultar atributos de campos Mostrar atributos dos campos objeto
  
  Um campo e sua falha de validação.
  
  Descrição string Obrigatório
  
  Falha na validação legível por humanos.
  
  Campo string Obrigatório
  
  Nome ou caminho do campo de solicitação inválido .
- detalhe string Obrigatório
  
  Detalhes de erro legíveis por humanos.
- Erro inteiro Obrigatório
  
  HTTP status code.
- Código de erro string Obrigatório
  
  Código de erro legível por máquina.
- Parâmetros array[string]
  
  Solicitar nomes de parâmetros associados ao erro; omitido quando nenhum se aplica.
- Razão string Obrigatório
  
  Frase de razão do status HTTP.
200

aplicação/vnd.agent-engine-2026-09-20-preview+json

aplicação/vnd.agent-engine-2026-09-20-preview+json aplicação/json

OK
Ocultar atributos de resposta Mostrar atributos de resposta objeto
- caller_ip string
  
  O CallerIP é o IP do administrador como o gateway o vê (Gin ClientIP / proxy confiável). Omitido quando desconhecido. Pipebacked aqui para que a interface do usuário da lista de acesso IP possa lê-la a partir da resposta da lista em cache (modelo Atlas; nenhuma API de ecossistema dedicada).
- próximo_cursor string
  
  NextCursor é o cursor do conjunto de chaves para a página seguinte; vazio quando esta página é a última. total sempre conta todo o escopo, ignorando o cursor.
- service_accounts array[objeto]
  
  Ocultar atributos service_accounts Mostrar atributos service_accounts objeto
  
  Active_secret objeto
  
  Ocultar atributos Active_secret Mostrar atributos Active_secret objeto
  
  created_at string
  
  expires_at string
  
  last_used_at string
  
  masked_value string
  
  client_id string
  
  created_at string
  
  Descrição string
  
  id string
  
  ip_access_list array[string]
  
  is_active booleano
  
  is_system_managed booleano
  
  name string
  
  org_id string
  
  Proprietário(a) string
  
  PROJECT_ID string
  
  role_assignments array[objeto]
  
  Ocultar atributos role_assignments Mostrar atributos role_assignments objeto
  
  org_id string
  
  PROJECT_ID string
  
  papel string
  
  type string
  
  updated_at string
- Total inteiro
Ocultar atributos de resposta Mostrar atributos de resposta objeto
- caller_ip string
  
  O CallerIP é o IP do administrador como o gateway o vê (Gin ClientIP / proxy confiável). Omitido quando desconhecido. Pipebacked aqui para que a interface do usuário da lista de acesso IP possa lê-la a partir da resposta da lista em cache (modelo Atlas; nenhuma API de ecossistema dedicada).
- próximo_cursor string
  
  NextCursor é o cursor do conjunto de chaves para a página seguinte; vazio quando esta página é a última. total sempre conta todo o escopo, ignorando o cursor.
- service_accounts array[objeto]
  
  Ocultar atributos service_accounts Mostrar atributos service_accounts objeto
  
  Active_secret objeto
  
  Ocultar atributos Active_secret Mostrar atributos Active_secret objeto
  
  created_at string
  
  expires_at string
  
  last_used_at string
  
  masked_value string
  
  client_id string
  
  created_at string
  
  Descrição string
  
  id string
  
  ip_access_list array[string]
  
  is_active booleano
  
  is_system_managed booleano
  
  name string
  
  org_id string
  
  Proprietário(a) string
  
  PROJECT_ID string
  
  role_assignments array[objeto]
  
  Ocultar atributos role_assignments Mostrar atributos role_assignments objeto
  
  org_id string
  
  PROJECT_ID string
  
  papel string
  
  type string
  
  updated_at string
- Total inteiro
400

aplicação/json

aplicação/json aplicação/vnd.agent-engine-2026-09-20-preview+json

Solicitação inválida
Ocultar atributos de resposta Mostrar atributos de resposta objeto
- código string
- Erro string
- Sucesso booleano
Ocultar atributos de resposta Mostrar atributos de resposta objeto
- código string
- Erro string
- Sucesso booleano
403

aplicação/json

aplicação/json aplicação/vnd.agent-engine-2026-09-20-preview+json

Proibido
Ocultar atributos de resposta Mostrar atributos de resposta objeto
- código string
- Erro string
- Sucesso booleano
Ocultar atributos de resposta Mostrar atributos de resposta objeto
- código string
- Erro string
- Sucesso booleano
404

aplicação/json

aplicação/json aplicação/vnd.agent-engine-2026-09-20-preview+json

Não encontrado
Ocultar atributos de resposta Mostrar atributos de resposta objeto
- código string
- Erro string
- Sucesso booleano
Ocultar atributos de resposta Mostrar atributos de resposta objeto
- código string
- Erro string
- Sucesso booleano
500

aplicação/json

aplicação/json aplicação/vnd.agent-engine-2026-09-20-preview+json

Erro interno do servidor
Ocultar atributos de resposta Mostrar atributos de resposta objeto
- código string
- Erro string
- Sucesso booleano
Ocultar atributos de resposta Mostrar atributos de resposta objeto
- código string
- Erro string
- Sucesso booleano

GET /api/v1/organizations/{id}/service-accounts

curl \
 --request GET 'https://agentengine.mongodb.com/api/v1/organizations/{id}/service-accounts' \
 --header "Authorization: $API_KEY"

Exemplos de resposta (406)

{
  "detail": "This operation is not available in API version 2026-09-20-preview.",
  "error": 406,
  "errorCode": "OPERATION_NOT_IN_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}

{
  "detail": "This operation supports text/event-stream, which the Accept header excludes. Remove unsupported media-type parameters or accept this type with a positive q value.",
  "error": 406,
  "errorCode": "UNACCEPTABLE_MEDIA_TYPE",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}

{
  "detail": "The requested API version is not supported. Supported versions: 2026-09-20-preview.",
  "error": 406,
  "errorCode": "UNSUPPORTED_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}

Exemplos de resposta (406)

{
  "detail": "This operation is not available in API version 2026-09-20-preview.",
  "error": 406,
  "errorCode": "OPERATION_NOT_IN_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}

Exemplos de resposta (200)

{
  "caller_ip": "string",
  "next_cursor": "string",
  "service_accounts": [
    {
      "active_secret": {
        "created_at": "string",
        "expires_at": "string",
        "last_used_at": "string",
        "masked_value": "string"
      },
      "client_id": "string",
      "created_at": "string",
      "description": "string",
      "id": "string",
      "ip_access_list": [
        "string"
      ],
      "is_active": true,
      "is_system_managed": true,
      "name": "string",
      "org_id": "string",
      "owner": "string",
      "project_id": "string",
      "role_assignments": [
        {
          "org_id": "string",
          "project_id": "string",
          "role": "string"
        }
      ],
      "type": "string",
      "updated_at": "string"
    }
  ],
  "total": 42
}

Exemplos de resposta (200)

{
  "caller_ip": "string",
  "next_cursor": "string",
  "service_accounts": [
    {
      "active_secret": {
        "created_at": "string",
        "expires_at": "string",
        "last_used_at": "string",
        "masked_value": "string"
      },
      "client_id": "string",
      "created_at": "string",
      "description": "string",
      "id": "string",
      "ip_access_list": [
        "string"
      ],
      "is_active": true,
      "is_system_managed": true,
      "name": "string",
      "org_id": "string",
      "owner": "string",
      "project_id": "string",
      "role_assignments": [
        {
          "org_id": "string",
          "project_id": "string",
          "role": "string"
        }
      ],
      "type": "string",
      "updated_at": "string"
    }
  ],
  "total": 42
}

Exemplos de resposta (400)

{
  "code": "string",
  "error": "string",
  "success": true
}

Exemplos de resposta (400)

{
  "code": "string",
  "error": "string",
  "success": true
}

Exemplos de resposta (403)

{
  "code": "string",
  "error": "string",
  "success": true
}

Exemplos de resposta (403)

{
  "code": "string",
  "error": "string",
  "success": true
}

Exemplos de resposta (404)

{
  "code": "string",
  "error": "string",
  "success": true
}

Exemplos de resposta (404)

{
  "code": "string",
  "error": "string",
  "success": true
}

Exemplos de resposta (500)

{
  "code": "string",
  "error": "string",
  "success": true
}

Exemplos de resposta (500)

{
  "code": "string",
  "error": "string",
  "success": true
}