API Reference

Admin

Organization

Projects

Model Permissions

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Modify project model permissions

POST/organization/projects/{project_id}/model_permissions

Updates model permissions for a project.

Path ParametersExpand Collapse

project_id: string

Body ParametersJSONExpand Collapse

mode: "allow_list" or "deny_list"

The model permissions mode to apply.

One of the following:

"allow_list"

"deny_list"

model_ids: array of string

The model IDs included in this permissions policy.

ReturnsExpand Collapse

ProjectModelPermissions object { mode, model_ids, object }

Represents the model allowlist or denylist policy for a project.

mode: "allow_list" or "deny_list"

Whether the project uses an allowlist or a denylist.

One of the following:

"allow_list"

"deny_list"

model_ids: array of string

The model IDs included in the model permissions policy.

object: "project.model_permissions"

The object type, which is always project.model_permissions.

Modify project model permissions

HTTP

HTTP

TypeScript

Python

Java

Go

Ruby

CLI Tool

curl -X POST https://api.openai.com/v1/organization/projects/proj_abc/model_permissions \
  -H "Authorization: Bearer $OPENAI_ADMIN_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "mode": "deny_list",
      "model_ids": [
          "o3"
      ]
  }'

{
    "object": "project.model_permissions",
    "mode": "deny_list",
    "model_ids": [
        "o3"
    ]
}

Returns Examples

{
    "object": "project.model_permissions",
    "mode": "deny_list",
    "model_ids": [
        "o3"
    ]
}