API Reference

Admin

Organization

Users

Roles

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Unassign organization role from user

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

DELETE/organization/users/{user_id}/roles/{role_id}

Unassigns an organization role from a user within the organization.

ParametersExpand Collapse

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 organization 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.users.roles.delete(
    role_id="role_id",
    user_id="user_id",
)
print(role.deleted)

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

Returns Examples

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