Sample - OpenAI API
GET/organization/groups/{group_id}/roles/{role_id}

Retrieve group organization role

Retrieves an organization role assigned to a group.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

2 parameters
group_idstringrequired
The ID of the group to inspect.
role_idstringrequired
The ID of the organization role to retrieve for the group.

2 status codes
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.
429The request was rejected because a rate limit was exceeded.
errorobjectrequired

Error handling

A 429 is returned: The request was rejected because a rate limit was exceeded.