Enumerar políticas de plataforma efectivas para un proyecto

OBTENER /api/v1/projects/{id}/policies/effective

Devuelve cada tipo de política resuelta para el proyecto: el valor efectivo combinado, el valor propio de cada ámbito y qué ámbito(s) están vigentes. Los valores de la organización se leen en el servidor, por lo que quien realiza la llamada solo necesita acceso de lectura al proyecto.

Parámetros de path

ID string Requerido

ID del proyecto

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 atributo de respuesta Mostrar atributo de respuesta Objeto
- políticas arreglo[objeto]
  
  Ocultar los atributos de la política Mostrar atributos de políticas Objeto
  
  valor_int_efectivo entero
  
  lista_de_cadenas_efectiva array[string]
  
  La lista de permisos aplicada. Un array vacío significa que no se permite nada, lo cual ocurre cuando las listas de organización y proyecto son independientes; null significa que no se aplica ninguna lista de permisos. Ambas listas no deben fusionarse.
  
  habilitado booleano
  
  organización Objeto
  
  Ocultar atributos de la organización Mostrar atributos de organización Objeto
  
  habilitado booleano
  
  valor_entero entero
  
  lista_de_cadenas array[string]
  
  Proyecto Objeto
  
  Ocultar atributos del proyecto Mostrar atributos del proyecto Objeto
  
  habilitado booleano
  
  ID string
  
  valor_entero entero
  
  lista_de_cadenas array[string]
  
  Origen string
  
  organización | proyecto | ambos | ninguno
  
  tipo string
  
  Los valores son MAX_TOOL_CALLS_PER_EXECUTION, MAX_LLM_CALLS_PER_EXECUTION, MAX_EXECUTION_DURATION_MS, MAX_TOKENS_PER_EXECUTION, MAX_TOKENS_PER_SESSION, AUTHORIZED_TOOLS o AUTHORIZED_MODELS.
Ocultar atributo de respuesta Mostrar atributo de respuesta Objeto
- políticas arreglo[objeto]
  
  Ocultar los atributos de la política Mostrar atributos de políticas Objeto
  
  valor_int_efectivo entero
  
  lista_de_cadenas_efectiva array[string]
  
  La lista de permisos aplicada. Un array vacío significa que no se permite nada, lo cual ocurre cuando las listas de organización y proyecto son independientes; null significa que no se aplica ninguna lista de permisos. Ambas listas no deben fusionarse.
  
  habilitado booleano
  
  organización Objeto
  
  Ocultar atributos de la organización Mostrar atributos de organización Objeto
  
  habilitado booleano
  
  valor_entero entero
  
  lista_de_cadenas array[string]
  
  Proyecto Objeto
  
  Ocultar atributos del proyecto Mostrar atributos del proyecto Objeto
  
  habilitado booleano
  
  ID string
  
  valor_entero entero
  
  lista_de_cadenas array[string]
  
  Origen string
  
  organización | proyecto | ambos | ninguno
  
  tipo string
  
  Los valores son MAX_TOOL_CALLS_PER_EXECUTION, MAX_LLM_CALLS_PER_EXECUTION, MAX_EXECUTION_DURATION_MS, MAX_TOKENS_PER_EXECUTION, MAX_TOKENS_PER_SESSION, AUTHORIZED_TOOLS o AUTHORIZED_MODELS.
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/projects/{id}/policies/effective

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

{
  "policies": [
    {
      "effective_int_value": 42,
      "effective_string_list": [
        "string"
      ],
      "enabled": true,
      "organization": {
        "enabled": true,
        "int_value": 42,
        "string_list": [
          "string"
        ]
      },
      "project": {
        "enabled": true,
        "id": "string",
        "int_value": 42,
        "string_list": [
          "string"
        ]
      },
      "source": "string",
      "type": "MAX_TOOL_CALLS_PER_EXECUTION"
    }
  ]
}

Ejemplos de respuesta (200)

{
  "policies": [
    {
      "effective_int_value": 42,
      "effective_string_list": [
        "string"
      ],
      "enabled": true,
      "organization": {
        "enabled": true,
        "int_value": 42,
        "string_list": [
          "string"
        ]
      },
      "project": {
        "enabled": true,
        "id": "string",
        "int_value": 42,
        "string_list": [
          "string"
        ]
      },
      "source": "string",
      "type": "MAX_TOOL_CALLS_PER_EXECUTION"
    }
  ]
}

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
}