创建组织平台策略

发布 /api/v1/organizations/{id}/policies

持有者身份验证

创建组织范围的平台策略，适用于组织中的每个项目。组织由路由 ID 路径参数承载。

路径参数

id 字符串必需

组织 ID

application/json

body 必需

要创建的策略

enabled 布尔
int_value 整型
PROJECT_ID 字符串
范围字符串

值为 org 或 project。
string_list array[string]
类型字符串必需

取值为 MAX_TOOL_CALLS_PER_EXECUTION、MAX_LLM_CALLS_PER_EXECUTION、MAX_EXECUTION_DURATION_MS、MAX_TOKENS_PER_EXECUTION、MAX_TOKENS_PER_SESSION、AUTHORIZED_TOOLS 或 AUTHORIZED_MODELS。

响应

406

application/json

application/json 应用程序/vnd.agent-engine-2026-09-20-preview+json

不支持或格式不正确的API版本、所选已发布合约中不可用的操作或不可接受的表示形式（包括不支持的媒体类型参数或排除的 SSE）。现有的身份验证、授权和速率限制失败优先。
隐藏响应属性显示响应属性对象
- badRequestDetail 对象
  
  标准错误模式定义的可选验证详细信息； API协商错误不会发出此字段。
  
  隐藏 BadRequestDetail 属性显示 BadRequestDetail 属性对象
  
  字段大量[对象]
  
  验证失败的字段。
  
  隐藏字段属性显示字段属性对象
  
  字段及其验证失败。
  
  描述字符串必需
  
  人类可读的验证失败。
  
  字段字符串必需
  
  无效请求字段的名称或路径。
- 详细信息字符串必需
  
  人类可读的错误详细信息。
- 错误整型必需
  
  HTTP status code.
- 错误代码字符串必需
  
  机器可读的错误代码。
- 参数 array[string]
  
  与错误相关的请求参数名称；不应用时省略。
- 原因字符串必需
  
  HTTP状态原因短语。
隐藏响应属性显示响应属性对象
- badRequestDetail 对象
  
  标准错误模式定义的可选验证详细信息； API协商错误不会发出此字段。
  
  隐藏 BadRequestDetail 属性显示 BadRequestDetail 属性对象
  
  字段大量[对象]
  
  验证失败的字段。
  
  隐藏字段属性显示字段属性对象
  
  字段及其验证失败。
  
  描述字符串必需
  
  人类可读的验证失败。
  
  字段字符串必需
  
  无效请求字段的名称或路径。
- 详细信息字符串必需
  
  人类可读的错误详细信息。
- 错误整型必需
  
  HTTP status code.
- 错误代码字符串必需
  
  机器可读的错误代码。
- 参数 array[string]
  
  与错误相关的请求参数名称；不应用时省略。
- 原因字符串必需
  
  HTTP状态原因短语。
201

应用程序/vnd.agent-engine-2026-09-20-preview+json

应用程序/vnd.agent-engine-2026-09-20-preview+json application/json

已创建
隐藏响应属性显示响应属性对象
- created_at 字符串
- created_by 字符串
- enabled 布尔
- id 字符串
- int_value 整型
- org_id 字符串
- PROJECT_ID 字符串
- 范围字符串
  
  值为 org 或 project。
- string_list array[string]
- 类型字符串
  
  取值为 MAX_TOOL_CALLS_PER_EXECUTION、MAX_LLM_CALLS_PER_EXECUTION、MAX_EXECUTION_DURATION_MS、MAX_TOKENS_PER_EXECUTION、MAX_TOKENS_PER_SESSION、AUTHORIZED_TOOLS 或 AUTHORIZED_MODELS。
- updated_at 字符串
- updated_by 字符串
隐藏响应属性显示响应属性对象
- created_at 字符串
- created_by 字符串
- enabled 布尔
- id 字符串
- int_value 整型
- org_id 字符串
- PROJECT_ID 字符串
- 范围字符串
  
  值为 org 或 project。
- string_list array[string]
- 类型字符串
  
  取值为 MAX_TOOL_CALLS_PER_EXECUTION、MAX_LLM_CALLS_PER_EXECUTION、MAX_EXECUTION_DURATION_MS、MAX_TOKENS_PER_EXECUTION、MAX_TOKENS_PER_SESSION、AUTHORIZED_TOOLS 或 AUTHORIZED_MODELS。
- updated_at 字符串
- updated_by 字符串
400

application/json

application/json 应用程序/vnd.agent-engine-2026-09-20-preview+json

Bad Request
隐藏响应属性显示响应属性对象
- 代码字符串
- 错误字符串
- Success 布尔
隐藏响应属性显示响应属性对象
- 代码字符串
- 错误字符串
- Success 布尔
403

application/json

application/json 应用程序/vnd.agent-engine-2026-09-20-preview+json

Forbidden
隐藏响应属性显示响应属性对象
- 代码字符串
- 错误字符串
- Success 布尔
隐藏响应属性显示响应属性对象
- 代码字符串
- 错误字符串
- Success 布尔
409

application/json

application/json 应用程序/vnd.agent-engine-2026-09-20-preview+json

冲突
隐藏响应属性显示响应属性对象
- 代码字符串
- 错误字符串
- Success 布尔
隐藏响应属性显示响应属性对象
- 代码字符串
- 错误字符串
- Success 布尔
500

application/json

application/json 应用程序/vnd.agent-engine-2026-09-20-preview+json

内部服务器错误
隐藏响应属性显示响应属性对象
- 代码字符串
- 错误字符串
- Success 布尔
隐藏响应属性显示响应属性对象
- 代码字符串
- 错误字符串
- Success 布尔

POST /api/v1/organizations/{id}/policies

curl \
 --request POST 'https://agentengine.mongodb.com/api/v1/organizations/{id}/policies' \
 --header "Authorization: $API_KEY" \
 --header "Content-Type: application/json" \
 --data '{
  "enabled": true,
  "int_value": 42,
  "project_id": "string",
  "scope": "org",
  "string_list": [
    "string"
  ],
  "type": "MAX_TOOL_CALLS_PER_EXECUTION"
}'

请求示例

{
  "enabled": true,
  "int_value": 42,
  "project_id": "string",
  "scope": "org",
  "string_list": [
    "string"
  ],
  "type": "MAX_TOOL_CALLS_PER_EXECUTION"
}

响应示例 (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"
}

响应示例 (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"
}

响应示例 (201)

{
  "created_at": "string",
  "created_by": "string",
  "enabled": true,
  "id": "string",
  "int_value": 42,
  "org_id": "string",
  "project_id": "string",
  "scope": "org",
  "string_list": [
    "string"
  ],
  "type": "MAX_TOOL_CALLS_PER_EXECUTION",
  "updated_at": "string",
  "updated_by": "string"
}

响应示例 (201)

{
  "created_at": "string",
  "created_by": "string",
  "enabled": true,
  "id": "string",
  "int_value": 42,
  "org_id": "string",
  "project_id": "string",
  "scope": "org",
  "string_list": [
    "string"
  ],
  "type": "MAX_TOOL_CALLS_PER_EXECUTION",
  "updated_at": "string",
  "updated_by": "string"
}

响应示例 (400)

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

响应示例 (400)

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

响应示例 (403)

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

响应示例 (403)

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

响应示例 (409)

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

响应示例 (409)

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

响应示例 (500)

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

响应示例 (500)

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