Lista de proyectos

OBTENER /api/v1/orgs/{orgId}/projects

Muestra los proyectos visibles para el usuario autenticado en función de sus roles asignados, con un alcance limitado a la organización especificada en la ruta URL.

Parámetros de path

orgId string Requerido

identificador de la organización

Respuestas

406

application/json

application/json aplicación/vnd.agent-engine-2026-09-20-preview+json

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

aplicación/vnd.agent-engine-2026-09-20-preview+json

aplicación/vnd.agent-engine-2026-09-20-preview+json application/json

OK
Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
- atlas_reauth_required booleano
  
  AtlasReauthRequired se establece en esta respuesta 200 cuando la concesión de Atlas no se puede utilizar, pero la puerta de enlace aún devuelve los últimos proyectos reflejados como de solo lectura. Los clientes deben iniciar la recuperación desde este campo; la lista de proyectos no devuelve 401 PLATFORM_OAUTH_*.
- Proyectos arreglo[objeto]
  
  Ocultar atributos de proyectos Mostrar atributos del proyecto Objeto
  
  permitir invitaciones de miembros booleano
  
  atlas Objeto
  
  Ocultar atributos del atlas Mostrar atributos del atlas Objeto
  
  entorno string Requerido
  
  ID string Requerido
  
  ID de organización string Requerido
  
  puede_gestionar_despliegues booleano
  
  created_at string
  
  Descripción string
  
  ID string
  
  Nombre string
  
  org_id string
  
  política de uso compartido Objeto
  
  Ocultar atributos de la política de uso compartido Mostrar atributos de la política de uso compartido Objeto
  
  fuentes permitidas array[string]
  
  modos de compartir array[string]
  
  compartible booleano
  
  Origen string
  
  Los valores son atlas o agent_engine.
  
  updated_at string
  
  número_de_espacio_de_trabajo entero
  
  WorkspaceCount es el número de espacios de trabajo no eliminados en el proyecto. Se incluye en las respuestas de lista y se omite en las solicitudes GET de un solo proyecto.
- Total entero
Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
- atlas_reauth_required booleano
  
  AtlasReauthRequired se establece en esta respuesta 200 cuando la concesión de Atlas no se puede utilizar, pero la puerta de enlace aún devuelve los últimos proyectos reflejados como de solo lectura. Los clientes deben iniciar la recuperación desde este campo; la lista de proyectos no devuelve 401 PLATFORM_OAUTH_*.
- Proyectos arreglo[objeto]
  
  Ocultar atributos de proyectos Mostrar atributos del proyecto Objeto
  
  permitir invitaciones de miembros booleano
  
  atlas Objeto
  
  Ocultar atributos del atlas Mostrar atributos del atlas Objeto
  
  entorno string Requerido
  
  ID string Requerido
  
  ID de organización string Requerido
  
  puede_gestionar_despliegues booleano
  
  created_at string
  
  Descripción string
  
  ID string
  
  Nombre string
  
  org_id string
  
  política de uso compartido Objeto
  
  Ocultar atributos de la política de uso compartido Mostrar atributos de la política de uso compartido Objeto
  
  fuentes permitidas array[string]
  
  modos de compartir array[string]
  
  compartible booleano
  
  Origen string
  
  Los valores son atlas o agent_engine.
  
  updated_at string
  
  número_de_espacio_de_trabajo entero
  
  WorkspaceCount es el número de espacios de trabajo no eliminados en el proyecto. Se incluye en las respuestas de lista y se omite en las solicitudes GET de un solo proyecto.
- Total entero
400

application/json

application/json aplicación/vnd.agent-engine-2026-09-20-preview+json

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

application/json

application/json aplicación/vnd.agent-engine-2026-09-20-preview+json

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
500

application/json

application/json aplicación/vnd.agent-engine-2026-09-20-preview+json

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/orgs/{orgId}/projects

curl \
 --request GET 'https://agentengine.mongodb.com/api/v1/orgs/{orgId}/projects' \
 --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)

{
  "atlas_reauth_required": true,
  "projects": [
    {
      "allow_member_invites": true,
      "atlas": {
        "environment": "string",
        "id": "string",
        "organization_id": "string"
      },
      "can_manage_deployments": true,
      "created_at": "string",
      "description": "string",
      "id": "string",
      "name": "string",
      "org_id": "string",
      "sharing_policy": {
        "allowed_sources": [
          "string"
        ],
        "share_modes": [
          "string"
        ],
        "shareable": true
      },
      "source": "atlas",
      "updated_at": "string",
      "workspace_count": 42
    }
  ],
  "total": 42
}

Ejemplos de respuesta (200)

{
  "atlas_reauth_required": true,
  "projects": [
    {
      "allow_member_invites": true,
      "atlas": {
        "environment": "string",
        "id": "string",
        "organization_id": "string"
      },
      "can_manage_deployments": true,
      "created_at": "string",
      "description": "string",
      "id": "string",
      "name": "string",
      "org_id": "string",
      "sharing_policy": {
        "allowed_sources": [
          "string"
        ],
        "share_modes": [
          "string"
        ],
        "shareable": true
      },
      "source": "atlas",
      "updated_at": "string",
      "workspace_count": 42
    }
  ],
  "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 (500)

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

Ejemplos de respuesta (500)

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