Skip to content

Guides and concepts for the OpenAI API

Endpoints, parameters, and responses

Guides, concepts, and product docs for Codex

Example workflows and tasks teams hand to Codex

Build apps to extend ChatGPT

Build commerce flows in ChatGPT

Demo apps to get inspired

Learnings and experiences from developers

Notebook examples for building with OpenAI models

Docs, videos, and demo apps for building with OpenAI

Programs, meetups, and support for builders

Search the API docs

Search docs

Suggested

Primary navigation

Search docs

Suggested

Get started

Overview
Quickstart
Models
Pricing
Libraries
Latest: GPT-5.4
Prompt guidance

Core concepts

Text generation
Code generation
Images and vision
Audio and speech
Structured output
Function calling
Responses API
Using tools

Agents SDK

Overview
Quickstart
Agent definitions
Models and providers
Running agents
Orchestration
Guardrails
Results and state
Integrations and observability
Evaluate agent workflows
Voice agents
Agent Builder

Tools

Web search
MCP and Connectors
Skills
Shell
Computer use
File search and retrieval
- File search
- Retrieval
Tool search
More tools

Run and scale

Conversation state
Background mode
Streaming
WebSocket mode
Webhooks
File inputs
Context management
Prompting
Reasoning
- Reasoning models
- Reasoning best practices

Evaluation

Getting started
Working with evals
Prompt optimizer
External models
Best practices

Realtime API

Overview
Connect
Usage

Model optimization

Optimization cycle
Fine-tuning
Graders

Specialized models

Image generation
Video generation
Text to speech
Speech to text
Deep research
Embeddings
Moderation

Going live

Production best practices
Latency optimization
Cost optimization
Accuracy optimization
Safety

Legacy APIs

Assistants API

Resources

Terms and policies
Changelog
Your data
Permissions
Rate limits
Deprecations
MCP for deep research
Developer mode
ChatGPT Actions

Getting Started

Overview
Quickstart
Explore
Pricing
Concepts

Using Codex

App
IDE Extension
CLI
Web
Integrations
Codex Security

Configuration

Config File
Speed
Rules
Hooks
AGENTS.md
MCP
Plugins
- Overview
- Build plugins
Skills
Subagents

Administration

Authentication
Agent approvals & security
Enterprise
Windows

Automation

Non-interactive Mode
Codex SDK
App Server
MCP Server
GitHub Action

Learn

Best practices
Videos
Community
Blog
Cookbooks
Building AI Teams

Releases

Changelog
Feature Maturity
Open Source

Home

Home
Quickstart

Core Concepts

MCP Apps in ChatGPT
MCP Server
UX principles
UI guidelines

Plan

Research use cases
Define tools
Design components

Build

Set up your server
Build your ChatGPT UI
Authenticate users
Manage state
Monetize your app
Examples

Deploy

Deploy your app
Connect from ChatGPT
Test your integration
Submit your app

Guides

Optimize Metadata
Security & Privacy
Troubleshooting

Resources

Changelog
App submission guidelines
Reference

Home

Guides

Get started
Best practices

File Upload

Overview
Products

API

Overview
Feeds
Products
Promotions

Home

All posts

Recent

How Perplexity Brought Voice Search to Millions Using the Realtime API
Designing delightful frontends with GPT-5.4
From prompts to products: One year of Responses
Using skills to accelerate OSS maintenance
Building frontend UIs with Codex and Figma

Topics

General
API
Apps SDK
Audio
Codex

Home

Topics

Agents
Evals
Multimodal
Text
Guardrails
Optimization
ChatGPT
Codex
gpt-oss

Contribute

Cookbook on GitHub

Home
Docs MCP

Categories

Demo apps
Videos

Topics

Agents
Audio & Voice
Computer use
Codex
Evals
gpt-oss
Fine-tuning
Image generation
Scaling
Tools
Video generation

Community

Programs

Codex Ambassadors
Codex for Students
Codex for Open Source

Events

Meetups
Hackathon Support

Forum
Discord

API API Reference Codex ChatGPT Resources

API Reference
API Reference
Responses API
Webhooks
- Events
- Unwrap
Platform APIs
- Audio
- Videos
- Images
- Embeddings
  - Create an embedding
- Evals
- Fine Tuning
  - Jobs
    Create a job
    Retrieve a job
    List jobs
    List Events
    Cancel a job
    Pause
    Resume
    Checkpoints
    List checkpoints
  - Checkpoints
    Permissions
    Create a permission
    Retrieve a permission
    Delete a permission
    List permissions
  - Alpha
    Graders
    Run
    Validate
- Batches
- Files
- Uploads
- Models
- Moderations
  - Create a moderation
Vector Stores
- Vector Stores
- Files
- File Batches
ChatKit
- Sessions
  - Create a session
  - Cancel a session
- Threads
Containers
- Containers
- Files
Skills
- Skills
Realtime
- Calls
- Client Secrets
  - Create a client secret
- Connect
- Client events
- Server events
Administration
- Overview
Chat Completions
- Chat Completions
Legacy
- Realtime Beta
  - Overview
- Assistants
- Completions
  - Create a completion

List user organization role assignments

GET/organization/users/{user_id}/roles

The method list is not implemented in Python, but it is available in the following languages:

HTTP