OpenAI 修改项目托管工具权限
2026-11-17 18:23 更新
修改项目托管工具权限
post /organization/projects/{project_id}/hosted_tool_permissions
更新项目的托管工具权限。
路径参数
project_id: string
项目 ID。
请求体参数
内容类型:application/json
code_interpreter: optional object { enabled } or null
代码解释器权限的更新设置。
enabled: boolean
是否为项目启用该托管工具。
file_search: optional object { enabled } or null
文件搜索权限的更新设置。
enabled: boolean
是否为项目启用该托管工具。
image_generation: optional object { enabled } or null
图像生成权限的更新设置。
enabled: boolean
是否为项目启用该托管工具。
mcp: optional object { enabled } or null
MCP 权限的更新设置。
enabled: boolean
是否为项目启用该托管工具。
web_search: optional object { enabled } or null
网页搜索权限的更新设置。
enabled: boolean
是否为项目启用该托管工具。
返回值
ProjectHostedToolPermissions object { code_interpreter, file_search, image_generation, 2 more }
表示项目的托管工具权限。
code_interpreter: object { enabled }
项目中单个托管工具的权限状态。
enabled: boolean
是否为项目启用了该托管工具。
file_search: object { enabled }
项目中单个托管工具的权限状态。
enabled: boolean
是否为项目启用了该托管工具。
image_generation: object { enabled }
项目中单个托管工具的权限状态。
enabled: boolean
是否为项目启用了该托管工具。
mcp: object { enabled }
项目中单个托管工具的权限状态。
enabled: boolean
是否为项目启用了该托管工具。
web_search: object { enabled }
项目中单个托管工具的权限状态。
enabled: boolean
是否为项目启用了该托管工具。
示例
## 从环境变量读取管理员密钥;先把项目、资源 ID 和请求参数替换为实际值
curl "https://api.openai.com/v1/organization/projects/$PROJECT_ID/hosted_tool_permissions" \
-H 'Content-Type: application/json' \
-H "Authorization: Bearer $OPENAI_ADMIN_KEY" \
-d '{}'
200 — 示例
{
"code_interpreter": {
"enabled": true
},
"file_search": {
"enabled": true
},
"image_generation": {
"enabled": true
},
"mcp": {
"enabled": true
},
"web_search": {
"enabled": true
}
}
示例
## 从环境变量读取管理员密钥;先把项目、资源 ID 和请求参数替换为实际值
curl -X POST "https://api.openai.com/v1/organization/projects/proj_abc/hosted_tool_permissions" \
-H "Authorization: Bearer $OPENAI_ADMIN_KEY" \
-H "Content-Type: application/json" \
-d '{
"file_search": {
"enabled": true
},
"image_generation": {
"enabled": false
}
}'
响应示例
{
"file_search": {
"enabled": true
},
"web_search": {
"enabled": true
},
"image_generation": {
"enabled": false
},
"mcp": {
"enabled": true
},
"code_interpreter": {
"enabled": true
}
}以上内容是否对您有帮助:

TRAE-AI编程


更多建议: