GET
/organization/groups/{group_id}/roles/{role_id}Retrieve group organization role
Retrieves an organization role assigned to a group.
group_idstringrequired
The ID of the group to inspect.
role_idstringrequired
The ID of the organization role to retrieve for the group.
200Organization role retrieved for the group successfully.
idstringrequired
Identifier for the role.
namestringrequired
Name of the role.
permissionsarray<string>required
Permissions associated with the role.
resource_typestringrequired
Resource type the role applies to.
predefined_rolebooleanrequired
Whether the role is predefined by OpenAI.
descriptionstringrequired
Description of the role.
created_atintegerrequired
When the role was created.
updated_atintegerrequired
When the role was last updated.
created_bystringrequired
Identifier of the actor who created the role.
created_by_user_objobjectrequired
User details for the actor that created the role, when available.
metadataobjectrequired
Arbitrary metadata stored on the role.
assignment_sourcesarray<object>required
Principals from which the role assignment is inherited, when available.
400The request parameters are invalid or the requested operation cannot be performed.
errorobjectrequired
403The caller does not have permission to perform this operation.
errorobjectrequired
Details about the permission error.
404The endpoint is unavailable or a requested resource was not found in this organization or project.
errorobjectrequired
429The request was rejected because a rate limit was exceeded.
errorobjectrequired
Error handling
A 400 is returned: The request parameters are invalid or the requested operation cannot be performed. A 403 is returned: The caller does not have permission to perform this operation. A 404 is returned: The endpoint is unavailable or a requested resource was not found in this organization or project. A 429 is returned: The request was rejected because a rate limit was exceeded.