API Reference

Admin

Organization

Projects

Users

Roles

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Unassign project role from user

admin.organization.projects.users.roles.delete(strrole_id, RoleDeleteParams**kwargs) -> RoleDeleteResponse

DELETE/projects/{project_id}/users/{user_id}/roles/{role_id}

Unassigns a project role from a user within a project.

ParametersExpand Collapse

project_id: str

user_id: str

role_id: str

ReturnsExpand Collapse

class RoleDeleteResponse: …

Confirmation payload returned after unassigning a role.

deleted: bool

Whether the assignment was removed.

object: str

Identifier for the deleted assignment, such as group.role.deleted or user.role.deleted.

Unassign project role from user

Python

HTTP

TypeScript

Python

Java

Go

Ruby

Terraform

import os
from openai import OpenAI

client = OpenAI(
    admin_api_key=os.environ.get("OPENAI_ADMIN_KEY"),  # This is the default and can be omitted
)
role = client.admin.organization.projects.users.roles.delete(
    role_id="role_id",
    project_id="project_id",
    user_id="user_id",
)
print(role.deleted)

{
    "object": "user.role.deleted",
    "deleted": true
}

Returns Examples

{
    "object": "user.role.deleted",
    "deleted": true
}