Skip to content
Primary navigation

Retrieve project model permissions

GET/organization/projects/{project_id}/model_permissions

Returns model permissions for a project.

Path ParametersExpand Collapse
project_id: string
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.

Retrieve project model permissions

curl https://api.openai.com/v1/organization/projects/proj_abc/model_permissions \
  -H "Authorization: Bearer $OPENAI_ADMIN_KEY" \
  -H "Content-Type: application/json"
{
    "object": "project.model_permissions",
    "mode": "allow_list",
    "model_ids": [
        "gpt-4.1",
        "o3"
    ]
}
Returns Examples
{
    "object": "project.model_permissions",
    "mode": "allow_list",
    "model_ids": [
        "gpt-4.1",
        "o3"
    ]
}