Eliminar un proyecto

Borrar /api/v1/proyectos/{id}
Autorización del portador

Elimina un proyecto de forma lógica. Devuelve 409 PROJECT_HAS_ACTIVE_WORKSPACES si existe algún espacio de trabajo activo en el proyecto (el usuario debe eliminar esos espacios de trabajo primero); de lo contrario, elimina el TenantEnvironment por proyecto y limpia las asignaciones de roles, las claves de API y las políticas.

Parámetros de path

  • ID string Requerido

    ID del proyecto

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.
  • 204

    Sin contenido

  • 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
  • 409

    Conflicto

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • detalle string

      alias de Error para compatibilidad con UI ApiError

    • Detalles Objeto
      Ocultar detalles de los atributos Mostrar detalles de los atributos Objeto
      • truncado booleano

        Se declara "truncado" cuando WorkspaceCount supera el límite y la vista previa es parcial.

      • número_de_espacio_de_trabajo entero

        WorkspaceCount es el número total de espacios de trabajo activos en el proyecto.

      • IDs de espacios de trabajo array[string]

        WorkspaceIDs son los primeros N (actualmente 10) ID de espacios de trabajo activos. Limitado para mantener la respuesta dentro de límites para proyectos con muchos espacios de trabajo.

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

      alias de Error para compatibilidad con UI ApiError

    • Detalles Objeto
      Ocultar detalles de los atributos Mostrar detalles de los atributos Objeto
      • truncado booleano

        Se declara "truncado" cuando WorkspaceCount supera el límite y la vista previa es parcial.

      • número_de_espacio_de_trabajo entero

        WorkspaceCount es el número total de espacios de trabajo activos en el proyecto.

      • IDs de espacios de trabajo array[string]

        WorkspaceIDs son los primeros N (actualmente 10) ID de espacios de trabajo activos. Limitado para mantener la respuesta dentro de límites para proyectos con muchos espacios de trabajo.

    • 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
ELIMINAR /api/v1/projects/{id} 
curl \
 --request DELETE 'https://agentengine.mongodb.com/api/v1/projects/{id}' \
 --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 (400) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (400) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (409) 
{
  "code": "string",
  "detail": "string",
  "details": {
    "truncated": true,
    "workspace_count": 42,
    "workspace_ids": [
      "string"
    ]
  },
  "error": "string",
  "success": true
}
Ejemplos de respuesta (409) 
{
  "code": "string",
  "detail": "string",
  "details": {
    "truncated": true,
    "workspace_count": 42,
    "workspace_ids": [
      "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
}