Read retrieve Role.

Contract-preserving GET Endpoint for retrieve Role in the OpenAI API. Model and resource-specific values are supplied by the caller at runtime.

All 288 OpenAI Platform REST endpoints from a fixed MIT-licensed official revision, including typed SSE streaming and Realtime call management. Hub provides documentation and an independent SDK/CLI, but never proxies model, account, or usage data; callers connect directly with local API keys.

Request

operationId: retrieveRole
Server: https://api.openai.com/v1
Authentication: ApiKeyAuth, AdminApiKeyAuth

Request parameters

`role_id`

pathstringrequired

role id value in the OpenAI API contract.

Responses

`200`

Roleapplication/json

Successful supplier response.

Properties: descriptionidnameobjectpermissionspredefined_roleresource_type

`429`

ErrorResponseapplication/json

Supplier response with HTTP status 429.

Properties: error

{
  "object": "role",
  "permissions": [],
  "predefined_role": false
}