v32

latestOpenAPI 3.1.0MITraw.githubusercontent.com2026-07-312881,4162.7 MB

User organization role assignments

Retrieve user organization role

Retrieves an organization role assigned to a user.

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

user_idstring required

The ID of the user to inspect.

role_idstring required

The ID of the organization role to retrieve for the user.

Organization role retrieved for the user successfully.

idstring required

Identifier for the role.

namestring required

Name of the role.

permissionsstring[] required

Permissions associated with the role.

resource_typestring required

Resource type the role applies to.

predefined_roleboolean required

Whether the role is predefined by OpenAI.

descriptionstring nullable required

Description of the role.

created_atinteger nullable required

When the role was created.

updated_atinteger nullable required

When the role was last updated.

created_bystring nullable required

Identifier of the actor who created the role.

created_by_user_objobject nullable required

User details for the actor that created the role, when available.

metadataobject nullable required

Arbitrary metadata stored on the role.