Skip to content
For the complete documentation index, see
llms.txt
. Markdown versions of documentation pages are available by appending
.md
to the page URL.
ChatGPT
Home
API
Codex
Docs
Guides, concepts, and product docs for Codex
Use cases
Example workflows and tasks teams can take on with ChatGPT or Codex
Docs
Use cases
Resources
ChatGPT
Plugins
Extend ChatGPT and Codex
Workspace Agents
Trigger published ChatGPT workspace agents
Commerce
Build commerce flows in ChatGPT
Ads
Publish and measure ads in ChatGPT
Resources
Showcase
Demo apps to get inspired
Blog
Learnings and experiences from developers
Cookbook
Notebook examples for building with OpenAI models
Learn
Docs, videos, and demo apps for building with OpenAI
Community
Programs, meetups, and support for builders
Start searching
API Dashboard
Try ChatGPT
Overview
Models
Agents
Tools
Audio & voice
Production
API reference
Search the API docs
Search docs
Suggested
responses create
reasoning_effort
realtime
prompt caching
Primary navigation
API
Codex
ChatGPT
Docs
Use cases
Resources
Resources
Search docs
Suggested
responses create
reasoning_effort
realtime
prompt caching
Overview
Models
Agents
Tools
Audio & voice
Production
API reference
Overview
Models
Agents
Tools
Audio & voice
Production
API reference
Docs
API reference
Docs
Use cases
Docs
Use cases
Docs
Docs
Plugins
Workspace Agents
Commerce
Ads
Plugins
Workspace Agents
Commerce
Ads
Docs
Select...
Showcase
Blog
Cookbook
Learn
Community
Showcase
Blog
Cookbook
Learn
Community
Docs
Select...
API Dashboard
Try ChatGPT
API
Codex
ChatGPT
Docs
Use cases
Resources
Resources
Overview
Models
Agents
Tools
Audio & voice
Production
API reference
API Reference
API Reference
Introduction
Authentication
Workload identity tokens
Debugging requests
Backwards compatibility
Responses API
Overview
Responses
Create a response
Retrieve a response
Delete a response
List input items
Count input tokens
Cancel a response
Compact a response
Connect
Conversations
Create a conversation
Retrieve a conversation
Update a conversation
Delete a conversation
Items
Create an item
Retrieve an item
Delete an item
List items
Streaming events
WebSocket events
Beta APIs
Responses (Multi-agent)
Create a responses (multi-agent)
Retrieve a responses (multi-agent)
Delete a responses (multi-agent)
Cancel a responses (multi-agent)
Compact a responses (multi-agent)
Connect
Input Items
List input items
Input Tokens
Count input tokens
Streaming events
WebSocket events
Webhooks
Events
Unwrap
Platform APIs
Live
Create session
Primary WebSocket
Sideband WebSocket
Fork WebSocket
Sessions
Accept session
Download Recording
Fork
Hangup
Refer
Reject
Audio
Create a speech
Create a transcription
Transcription streaming events
Create a translation
Videos
Create a video
Create Character
Get Character
Retrieve a video
Delete a video
List videos
Download Content
Edit
Extend
Remix
Images
Generate an Image
Edit an Image
Create Variation
Image generation streaming events
Image edit streaming events
Embeddings
Create an embedding
Evals
Create an eval
Retrieve an eval
Update an eval
Delete an eval
List evals
Runs
Create a run
Retrieve a run
Delete a run
List runs
Cancel a run
Output Items
Retrieve an output item
List output items
Fine Tuning
Alpha
Graders
Run
Validate
Checkpoints
Permissions
Create a permission
Retrieve a permission
Delete a permission
List permissions
Jobs
Create a job
Retrieve a job
List jobs
List Events
Cancel a job
Pause
Resume
Checkpoints
List checkpoints
Batches
Create a batch
Retrieve a batch
List batches
Cancel a batch
Files
List files
Create a file
Retrieve a file
Delete a file
Retrieve file content
Retrieve Content
Uploads
Create an upload
Cancel an upload
Complete
Parts
Create a part
Models
Retrieve a model
Delete a model
List models
Moderations
Create a moderation
Safety Alerts
Retrieve a safety alert
Content Provenance Checks
Create a content provenance check
Agents API
Create an agent
Retrieve an agent
Update an agent
Delete an agent
List agents
Environments
Retrieve an environment
Files
List files
Create a file
Templates
Create a template
Retrieve a template
Update a template
Delete a template
List templates
Sessions
Create a session
Retrieve a session
Update a session
Delete a session
List sessions
Artifacts
Retrieve an artifact
Delete an artifact
List artifacts
Retrieve artifact content
Events
Create an event
Stream
Items
List items
Subagents
Retrieve a subagent
List subagents
Items
List items
Turns
Retrieve a turn
List turns
Items
List items
Turns
Retrieve a turn
List turns
Vaults
Create a vault
Retrieve a vault
Delete a vault
List vaults
Credentials
Create a credential
Retrieve a credential
Update a credential
Delete a credential
List credentials
Streaming events
Vector Stores
Vector Stores
Create a vector store
Retrieve a vector store
Update a vector store
Delete a vector store
List vector stores
Search
File Batches
Create a file batch
Retrieve a file batch
List Files
Cancel a file batch
Files
List files
Create a file
Retrieve a file
Update a file
Delete a file
Retrieve file content
ChatKit
Sessions
Create a session
Cancel a session
Threads
Retrieve a thread
Delete a thread
List threads
List Items
Containers
Containers
Create a container
Retrieve a container
Delete a container
List containers
Files
List files
Create a file
Retrieve a file
Delete a file
Content
Retrieve a content
Skills
Skills
Create a skill
Retrieve a skill
Retrieve skill content
Update a skill
Delete a skill
List skills
Versions
Create skill version
Retrieve skill version
Retrieve Skill Version Content
Delete skill version
List skill versions
Realtime
Translations
Translation client events
Translation server events
Calls
Create a call
Accept
Hangup
Refer
Reject
Client Secrets
Create a client secret
Connect
Client events
Server events
Administration
Overview
Admin API Keys
Create an admin API key
Retrieve an admin API key
Delete an admin API key
List admin API keys
Audit Logs
List audit logs
Certificates
Create a certificate
Retrieve a certificate
Update a certificate
Delete a certificate
List certificates
Activate
Deactivate
Data Retention
Retrieve a data retention
Update a data retention
Groups
Create a group
Retrieve a group
Update a group
Delete a group
List groups
Roles
Create a role
Retrieve a role
Delete a role
List roles
Users
Create an user
Retrieve an user
Delete an user
List users
Invites
Create an invite
Retrieve an invite
Delete an invite
List invites
Projects
Create a project
Retrieve a project
Update a project
List projects
Archive
API Keys
Retrieve an API key
Delete an API key
List API keys
Certificates
List certificates
Activate
Deactivate
Data Retention
Retrieve a data retention
Update a data retention
Groups
Create a group
Retrieve a group
Delete a group
List groups
Roles
Create a role
Retrieve a role
Delete a role
List roles
Hosted Tool Permissions
Retrieve a hosted tool permission
Update a hosted tool permission
Model Permissions
Retrieve a model permission
Update a model permission
Delete a model permission
Rate Limits
Update Rate Limit
List Rate Limits
Roles
Create a role
Retrieve a role
Update a role
Delete a role
List roles
Service Accounts
Create a service account
Retrieve a service account
Update a service account
Delete a service account
List service accounts
API Keys
Create an API key
Spend Alerts
Create a spend alert
Retrieve a spend alert
Update a spend alert
Delete a spend alert
List spend alerts
Spend Limit
Retrieve a spend limit
Update a spend limit
Delete a spend limit
Users
Create an user
Retrieve an user
Update an user
Delete an user
List users
Roles
Create a role
Retrieve a role
Delete a role
List roles
Roles
Create a role
Retrieve a role
Update a role
Delete a role
List roles
Spend Alerts
Create a spend alert
Retrieve a spend alert
Update a spend alert
Delete a spend alert
List spend alerts
Spend Limit
Retrieve a spend limit
Update a spend limit
Delete a spend limit
Usage
Audio Speeches
Audio Transcriptions
Code Interpreter Sessions
Completions
Costs
Embeddings
File Search Calls
Images
Moderations
Vector Stores
Web Search Calls
Users
Retrieve an user
Update an user
Delete an user
List users
Roles
Create a role
Retrieve a role
Delete a role
List roles
Chat Completions
Chat Completions
Overview
Create a chat completion
Retrieve a chat completion
Update a chat completion
Delete a chat completion
List chat completions
List chat completions
Streaming events
Legacy
Realtime Beta
Overview
Completions
Create a completion
API Reference
Safety
Copy Markdown
Open in
Claude
Open in
ChatGPT
Open in
Cursor
Copy Markdown
View as Markdown
Alerts
Get project safety alert
safety.alerts.
retrieve
(
str
id
)
->
SafetyAlert
GET
/safety/alerts/{id}
Models
Expand
Collapse
class
SafetyAlert
:
…
View schema details
