openai/openai-openapi

View on GitHub

OpenAPI specification for the OpenAI API

Stars: 2.5k
Forks: 527
Open beginner issues: 0
Indexed issues: 87
Avg merge: 1h 46m
Merged PRs (30d): 2

Dominant language: No language data
License: MIT
Last GitHub push: Sep 19, 2026
Latest indexed: Sep 19, 2026
Contributing guide: Contributing guide
Code of conduct: No code of conduct
Beginner labels: No beginner labels indexed

Beginner friendly Everything

Open All

87 open issues indexed

VoiceIdsShared omits fable, onyx, and nova documented for speech Open

bug specification

Difficulty 2/5 1-3 hours Newbie friendliness 82/100

openai/openai-openapi#581 · Opened Sep 6, 2026
GraderMulti.graders models one grader instead of a named dictionary Open

bug documentation specification

Difficulty 4/5 3-5 days Newbie friendliness 68/100

openai/openai-openapi#580 · Opened Sep 6, 2026
ConversationResource.metadata has no machine-readable map type Open

bug specification

Difficulty 3/5 1-2 days Newbie friendliness 68/100

openai/openai-openapi#579 · Opened Sep 6, 2026
Publish schemas for Batch input and output/error JSONL records Open

enhancement specification

Difficulty 4/5 3-5 days Newbie friendliness 48/100

openai/openai-openapi#578 · Opened Sep 6, 2026
ChatCompletionStreamResponseDelta omits streamed audio data Open

bug documentation specification

Difficulty 3/5 1-2 days Newbie friendliness 70/100

openai/openai-openapi#577 · Opened Sep 6, 2026
ChatCompletionMessageToolCallChunk is missing streamed custom tool calls Open

bug documentation specification

Difficulty 3/5 1-2 days Newbie friendliness 68/100

openai/openai-openapi#576 · Opened Sep 6, 2026
Image generation call replay incorrectly requires result and status Open

bug specification

Difficulty 3/5 1-2 days Newbie friendliness 68/100

openai/openai-openapi#575 · Opened Sep 6, 2026
ImageGenToolCall omits returned image metadata fields Open

bug specification

Difficulty 3/5 1-2 days Newbie friendliness 68/100

openai/openai-openapi#574 · Opened Sep 6, 2026
WebSearchActionSearch.sources omits specialized api sources and their name field Open

bug documentation specification

Difficulty 2/5 1-3 hours Newbie friendliness 82/100

openai/openai-openapi#573 · Opened Sep 6, 2026
WebSearchToolCall incorrectly requires an action on every returned item Open

bug specification

Difficulty 2/5 1-3 hours Newbie friendliness 78/100

openai/openai-openapi#572 · Opened Sep 6, 2026
Reconcile find_in_page URL presence across API responses and SDK validation Open

bug specification

Difficulty 4/5 3-5 days Newbie friendliness 42/100

openai/openai-openapi#571 · Opened Sep 6, 2026
Realtime transcription WebSocket event schemas require REST-only client_secret and are omitted from RealtimeServerEvent Open

bug documentation specification

Difficulty 3/5 1-2 days Newbie friendliness 70/100

openai/openai-openapi#568 · Opened Aug 29, 2026
Audio transcription response oneOf variants overlap, misclassifying diarized_json Open

bug specification

Difficulty 5/5 Over a week Newbie friendliness 38/100

openai/openai-openapi#567 · Opened Aug 29, 2026
Add explicit discriminator mappings for Realtime session configuration unions Open

enhancement specification

Difficulty 2/5 Half a day Newbie friendliness 72/100

openai/openai-openapi#566 · Opened Aug 23, 2026
Request and response message models should be separated to avoid applying output-only requirements to request payloads Open

bug question specification

Difficulty 5/5 Over a week Newbie friendliness 45/100

openai/openai-openapi#565 · Opened Aug 20, 2026
Represent Responses API beta variants without `?beta=true` in OpenAPI path keys Open

bug specification

Difficulty 4/5 3-5 days Newbie friendliness 48/100

openai/openai-openapi#562 · 1 comment · Opened Jul 26, 2026
Make `Responses` tagging complete and consistent across the OpenAPI document Open

enhancement specification

Difficulty 3/5 1-2 days Newbie friendliness 72/100

openai/openai-openapi#561 · Opened Jul 26, 2026
`gpt-5.5` under-reports `usage.output_tokens` for grammar-constrained custom-tool generations Open

api upstream

Difficulty 5/5 Over a week Newbie friendliness 35/100

openai/openai-openapi#554 · Opened Jun 18, 2026
Invalid exclusiveMinimum, missing discriminator mapping, and suspicious integer bounds Open

bug question specification

Difficulty 3/5 1-2 days Newbie friendliness 55/100

openai/openai-openapi#549 · Opened Jun 14, 2026
Having issues with propertyName: type when using swift-openapi-generator Open

bug question specification

Difficulty 5/5 Over a week Newbie friendliness 38/100

openai/openai-openapi#542 · 2 reactions · Opened May 20, 2026
[Streaming] Token usage not returned when stream is aborted mid-generation Open

api enhancement

Difficulty 5/5 Over a week Newbie friendliness 35/100

openai/openai-openapi#539 · 1 comment · Opened Apr 5, 2026
Proposal: Add capabilities field to /v1/models response Open

api enhancement

Difficulty 5/5 Over a week Newbie friendliness 45/100

openai/openai-openapi#537 · 16 reactions · Opened Mar 25, 2026
Responses API: undocumented reasoning+message pairing constraint breaks multi-turn conversations across all SDKs Open

api bug enhancement specification

Difficulty 5/5 Over a week Newbie friendliness 35/100

openai/openai-openapi#536 · 1 comment · Opened Mar 24, 2026
Non-existent properties are defined as required Open

bug specification

Difficulty 2/5 1-3 hours Newbie friendliness 62/100

openai/openai-openapi#532 · 2 reactions · Opened Mar 5, 2026
Error property for MCPToolCall and MCPListTools is specified as string instead of object Open

bug specification

Difficulty 2/5 1-3 hours Newbie friendliness 65/100

openai/openai-openapi#531 · 1 comment · Opened Feb 26, 2026
Lack of unixtime format for lots of properties Open

enhancement specification

Difficulty 3/5 1-2 days Newbie friendliness 45/100

openai/openai-openapi#528 · Opened Feb 12, 2026
Multipart request bodies are missing encoding information Open

bug enhancement specification

Difficulty 4/5 3-5 days Newbie friendliness 35/100

openai/openai-openapi#527 · Opened Feb 12, 2026
The specification should be upgraded to OpenAPI 3.2.0 to take advantage of new streaming place holders Open

enhancement specification

Difficulty 4/5 3-5 days Newbie friendliness 35/100

openai/openai-openapi#526 · Opened Feb 12, 2026
Duplicate top_logprobs properties across type hierarchies Open

bug enhancement specification

Difficulty 4/5 3-5 days Newbie friendliness 38/100

openai/openai-openapi#525 · Opened Feb 12, 2026
The description is missing error responses entirely Open

enhancement specification

Difficulty 4/5 3-5 days Newbie friendliness 35/100

openai/openai-openapi#524 · Opened Feb 12, 2026
Inline union schemas produce unstable generated type names (Object124, etc.) Open

enhancement specification

Difficulty 4/5 3-5 days Newbie friendliness 35/100

openai/openai-openapi#522 · 1 comment · Opened Jan 27, 2026
suggestion on logprobs Open

api enhancement

Difficulty 5/5 Over a week Newbie friendliness 25/100

openai/openai-openapi#520 · Opened Jan 26, 2026
Mixing OpenAPI 3.0.x and 3.1.x Open

bug specification

Difficulty 3/5 1-2 days Newbie friendliness 42/100

openai/openai-openapi#519 · 2 comments · Opened Jan 24, 2026
Missing extra_content.google.thought_signature Open

enhancement specification

Difficulty 5/5 Over a week Newbie friendliness 25/100

openai/openai-openapi#517 · 1 reaction · Opened Jan 22, 2026
RealtimeResponseCreateParams does not support item_reference despite being documented in response.create example Open

bug specification

Difficulty 3/5 1-2 days Newbie friendliness 50/100

openai/openai-openapi#514 · Opened Jan 19, 2026
Outdated Examples in Realtime Conversation Docs Open

documentation specification

openai/openai-openapi#513 · 1 assignee · Opened Jan 12, 2026
Why is ChatCompletionTool documented as "Function tool"? Open

question

Difficulty 2/5 1-3 hours Newbie friendliness 35/100

openai/openai-openapi#510 · Opened Dec 19, 2025
Chat completion chunk object's `choices.delta.role` should be `string or null` Open

Difficulty 2/5 1-3 hours Newbie friendliness 45/100

openai/openai-openapi#504 · 1 reaction · Opened Nov 18, 2025
Unsupported content type: 'multipart/form-data' Open

api

Difficulty 4/5 3-5 days Newbie friendliness 25/100

openai/openai-openapi#502 · Opened Nov 11, 2025
openapi schema validation errors Open

bug documentation question specification

Difficulty 4/5 3-5 days Newbie friendliness 25/100

openai/openai-openapi#499 · Opened Oct 23, 2025
Properties using the `InputFidelity` are missing the default Open

enhancement specification

Difficulty 2/5 1-3 hours Newbie friendliness 58/100

openai/openai-openapi#498 · Opened Oct 23, 2025
The content property of `Message` is missing "InputAudioContent" Open

specification

Difficulty 2/5 1-3 hours Newbie friendliness 55/100

openai/openai-openapi#496 · Opened Oct 21, 2025
The content property of `Message` model includes variants that do not exist Open

Difficulty 2/5 1-3 hours Newbie friendliness 45/100

openai/openai-openapi#495 · Opened Oct 21, 2025
The role property of `Message` model includes values that do not exist Open

Difficulty 2/5 1-3 hours Newbie friendliness 50/100

openai/openai-openapi#494 · Opened Oct 21, 2025
Consider renaming the models that extend `ItemResource` for consistency Open

enhancement specification

Difficulty 3/5 1-2 days Newbie friendliness 45/100

openai/openai-openapi#493 · Opened Oct 21, 2025
response schema missing for `operationId: deleteResponse` Open

bug documentation specification

Difficulty 2/5 1-3 hours Newbie friendliness 78/100

openai/openai-openapi#490 · 1 comment · 3 reactions · Opened Oct 15, 2025
OpenAI use of `type:` instead of `event:` in Server-Sent Event (SSE) framing as per the official WHATWG HTML Living Standard Open

api question specification

Difficulty 5/5 Over a week Newbie friendliness 32/100

openai/openai-openapi#489 · 1 comment · 1 reaction · Opened Oct 8, 2025
all webhooks are missing operation ids Open

enhancement specification

Difficulty 3/5 1-2 days Newbie friendliness 45/100

openai/openai-openapi#485 · 1 comment · 2 reactions · Opened Sep 12, 2025
description is using lots of nullable:true which is invalid according to OAS 3.1.0 Open

bug specification

Difficulty 4/5 3-5 days Newbie friendliness 35/100

openai/openai-openapi#483 · Opened Sep 12, 2025
@Size annotation not being generated for a string field if not mentioned in required section of the yaml spec Open

question

Difficulty 3/5 1-2 days Newbie friendliness 42/100

openai/openai-openapi#478 · Opened Aug 22, 2025

openai/openai-openapi

Get new issues in your inbox