OpenAI API (unofficial showcase)
GET/organization/roles

List organization roles

Lists roles configured for the organization. Use limit to control the number of roles returned and order to choose the sort direction. Continue through the results with the after cursor from the previous response's next field.

3 parameters
limitintegeroptional
Maximum number of roles to return, from 0 to 1000. Defaults to 1000 when omitted.
Default:1000
afterstringoptional
Pagination cursor from the previous response's `next` field; use it to continue listing roles.
orderstringoptional
Sort order for the returned roles: `asc` or `desc`. Defaults to `asc` when omitted.
Allowed:ascdescDefault:asc

5 status codes
200Returns a paginated list of roles with the current page of role objects, a `has_more` flag, and a `next` cursor that is null when no further roles are available.
objectstringrequired
Always `list`.
Allowed:list
dataarray<object>required
Roles returned in the current page.
has_morebooleanrequired
Whether more roles are available when paginating.
nextstringrequired
Cursor to fetch the next page of results, or `null` when there are no additional roles.
400Returned when the request parameters are invalid or the requested operation cannot be performed.
errorobjectrequired
403Returned when the caller does not have permission to perform this operation.
errorobjectrequired
Details about the permission error.
404Returned when the endpoint is unavailable or a requested resource is not found in the organization or project.
errorobjectrequired
429Returned when the request is rejected because a rate limit was exceeded.
errorobjectrequired

Error handling

A 400 is returned when the request parameters are invalid or the requested operation cannot be performed. A 403 is returned when the authenticated user does not have permission, a 404 when the endpoint is unavailable or a requested resource is not found, and a 429 when a rate limit is exceeded. limit must be between 0 and 1000, and order must be asc or desc.