Lista de cuentas de servicio de la organización

OBTENER /api/v1/organizations/{id}/service-accounts
Autorización del portador

Muestra las cuentas de servicio al cliente con ámbito de organización. Requiere permisos de ORG_ADMIN o ORG_MEMBER (solo lectura).

Parámetros de path

  • ID string Requerido

    identificador de la organización

Parámetros de query

  • limit entero

    Tamaño de página (predeterminado 50, máximo 200)

  • cursor string

    Cursor de teclas del next_cursor de una respuesta anterior

Respuestas

  • 406

    Versión de API no compatible o con formato incorrecto, operación no disponible en el contrato publicado seleccionado o representación inaceptable (incluidos parámetros de tipo de medio no compatibles o SSE excluidos). Los fallos de autenticación, autorización y límite de velocidad existentes tienen prioridad.

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • badRequestDetail Objeto

      Detalles de validación opcionales definidos por el esquema de error estándar; los errores de negociación de la API no emiten este campo.

      Ocultad el atributo badRequestDetail Mostrar el atributo badRequestDetail Objeto
      • Campos arreglo[objeto]

        Campos con errores de validación.

        Ocultar campos atributos Mostrar los atributos de los campos Objeto

        Un campo y su fallo de validación.

        • Descripción string Requerido

          Fallo en la validación legible para humanos.

        • Campo string Requerido

          Nombre o ruta del campo de solicitud no válido.

    • detalle string Requerido

      Detalles de errores legibles para humanos.

    • Error entero Requerido

      HTTP status code.

    • errorCode string Requerido

      Código de error legible por máquina.

    • Parámetros array[string]

      Nombres de los parámetros de la solicitud asociados con el error; se omiten cuando no corresponde ninguno.

    • motivo string Requerido

      Frase que indica el motivo del estado HTTP.

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • badRequestDetail Objeto

      Detalles de validación opcionales definidos por el esquema de error estándar; los errores de negociación de la API no emiten este campo.

      Ocultad el atributo badRequestDetail Mostrar el atributo badRequestDetail Objeto
      • Campos arreglo[objeto]

        Campos con errores de validación.

        Ocultar campos atributos Mostrar los atributos de los campos Objeto

        Un campo y su fallo de validación.

        • Descripción string Requerido

          Fallo en la validación legible para humanos.

        • Campo string Requerido

          Nombre o ruta del campo de solicitud no válido.

    • detalle string Requerido

      Detalles de errores legibles para humanos.

    • Error entero Requerido

      HTTP status code.

    • errorCode string Requerido

      Código de error legible por máquina.

    • Parámetros array[string]

      Nombres de los parámetros de la solicitud asociados con el error; se omiten cuando no corresponde ninguno.

    • motivo string Requerido

      Frase que indica el motivo del estado HTTP.
  • 200

    OK

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • dirección IP del remitente string

      CallerIP es la IP del administrador tal como la ve la puerta de enlace (IP del cliente Gin / proxy de confianza). Se omite cuando se desconoce. Se incluye aquí para que la interfaz de usuario de la lista de acceso IP pueda leerla desde la respuesta de la lista almacenada en caché (estilo Atlas; sin API de eco dedicada).

    • siguiente_cursor string

      NextCursor es el cursor del conjunto de teclas para la página siguiente; vacío cuando esta página es la última. total siempre cuenta todo el ámbito, ignorando el cursor.

    • cuentas_de_servicio arreglo[objeto]
      Ocultar atributos de cuentas de servicio Mostrar atributos de cuentas de servicio Objeto
      • secreto activo Objeto
        Ocultar atributos active_secret Mostrar atributos de active_secret Objeto
        • created_at string
        • expira_en string
        • último_usado_en string
        • masked_value string
      • client_id string
      • created_at string
      • Descripción string
      • ID string
      • ip_access_list array[string]
      • está_activo booleano
      • ¿Es administrado por el sistema? booleano
      • Nombre string
      • org_id string
      • propietario string
      • project_id string
      • asignaciones de roles arreglo[objeto]
        Ocultar atributos de asignación de roles Mostrar atributos de asignación de roles Objeto
        • org_id string
        • project_id string
        • rol string
      • tipo string
      • updated_at string
    • Total entero
    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • dirección IP del remitente string

      CallerIP es la IP del administrador tal como la ve la puerta de enlace (IP del cliente Gin / proxy de confianza). Se omite cuando se desconoce. Se incluye aquí para que la interfaz de usuario de la lista de acceso IP pueda leerla desde la respuesta de la lista almacenada en caché (estilo Atlas; sin API de eco dedicada).

    • siguiente_cursor string

      NextCursor es el cursor del conjunto de teclas para la página siguiente; vacío cuando esta página es la última. total siempre cuenta todo el ámbito, ignorando el cursor.

    • cuentas_de_servicio arreglo[objeto]
      Ocultar atributos de cuentas de servicio Mostrar atributos de cuentas de servicio Objeto
      • secreto activo Objeto
        Ocultar atributos active_secret Mostrar atributos de active_secret Objeto
        • created_at string
        • expira_en string
        • último_usado_en string
        • masked_value string
      • client_id string
      • created_at string
      • Descripción string
      • ID string
      • ip_access_list array[string]
      • está_activo booleano
      • ¿Es administrado por el sistema? booleano
      • Nombre string
      • org_id string
      • propietario string
      • project_id string
      • asignaciones de roles arreglo[objeto]
        Ocultar atributos de asignación de roles Mostrar atributos de asignación de roles Objeto
        • org_id string
        • project_id string
        • rol string
      • tipo string
      • updated_at string
    • Total entero
  • 400

    Solicitud incorrecta

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
  • 403

    Forbidden

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
  • 404

    No encontrado

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
  • 500

    Error interno del servidor

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito 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"
Ejemplos de respuesta (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"
}
Ejemplos de respuesta (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"
}
Ejemplos de respuesta (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
}
Ejemplos de respuesta (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
}
Ejemplos de respuesta (400) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (400) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (403) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (403) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (404) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (404) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (500) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (500) 
{
  "code": "string",
  "error": "string",
  "success": true
}