v1

latestOpenAPI 3.1.0MIT2026-07-132429592.7 MB

Roles

Updates an existing project role.

post/projects/{project_id}/roles/{role_id}

project_idstring required

The ID of the project to update.

role_idstring required

The ID of the role to update.

permissionsstring[] nullable

Updated set of permissions for the role.

descriptionstring nullable

New description for the role.

role_namestring nullable

New name for the role.

Project role updated successfully.

object'role' required

Always role.

idstring required

Identifier for the role.

namestring required

Unique name for the role.

descriptionstring nullable required

Optional description of the role.

permissionsstring[] required

Permissions granted by the role.

resource_typestring required

Resource type the role is bound to (for example api.organization or api.project).

predefined_roleboolean required

Whether the role is predefined and managed by OpenAI.