ErrLookup › openai/openai-python

openai/openai-python

The official Python library for the OpenAI API · Python · 1,544 source files

Analyzed at 9917c6e28e on 2026-08-28. 183 documented errors.

Code / Message	Type	Severity	Tags
Could not resolve inner type variable at index	exception	error	typing, generics, typevar, runtimeerror
invalid type; expected	validation	error	typeerror, datetime, coercion, validation
a value for placeholder	validation	error	keyerror, path-params, url-template, api-usage
The given webhook signature does not match the expected…	exception	critical	webhooks, signature-verification, hmac, invalid-signature, security
invalid datetime format	validation	error	valueerror, datetime, iso8601, parsing
Failed to fetch Azure subject token from IMDS	exception	critical	azure, imds, network, auth
Unknown array_format value	exception	warning	notimplementederror, internal-api, serialization, multipart
Could not read bytes from	validation	error	runtimeerror, file-upload, serialization, base64
Missing stream class	exception	error	streaming, client-setup, sdk-internal
Constructed path contains dot-segment which is not allowed	validation	error	path-traversal, url-validation, security, valueerror
Failed to read the token file at	exception	critical	kubernetes, workload-identity, auth, file-io
A single event handler cannot be shared between multiple…	exception	error	assistants, streaming, event-handler, reuse, python
() takes argument(s) but were given	validation	error	typeerror, arity, function-signature, api-usage
Missing required arguments	validation	error	typeerror, required-args, overloads, api-usage
Failed to fetch GCP subject token from metadata server: HTTP	http	critical	gcp, metadata-server, auth, cloud-identity
Expected a non-empty value for `role_id` but received	validation	error	openai-python, admin-api, validation, path-parameter, roles
Failed to fetch Azure subject token from IMDS: HTTP	http	critical	azure, managed-identity, imds, auth
You tried to pass a `BaseModel` class to…	validation	error	python, openai, pydantic, structured-output, typeerror, chat-completions
invalid date format	validation	error	valueerror, date, iso8601, parsing
Unexpected list delta entry is not a dictionary	exception	error	streaming, delta-accumulation, typeerror, schema-mismatch, python
Cannot provide both response_id/starting_after can't be…	validation	error	responses, streaming, parameter-validation, api-misuse
Non BaseModel types are only supported with Pydantic v2	validation	error	json-schema, pydantic, strict-mode
WebSocket connection closed with unsent messages	error_code	error	python, websocket, responses-api, network, async
Expected a non-empty value for `eval_id` but received	validation	error	openai, evals, value-error, path-parameter, client-side-validation
Stream has not been started yet	exception	error	assistants, streaming, context-manager, iteration-order, python
Expected a non-empty value for `permission_id` but received	validation	error	python, openai, fine-tuning, permissions, delete, path-parameter, valueerror
The webhook secret must either be set using the env var…	exception	error	webhooks, signature-verification, missing-secret, configuration, env-var
Didn't receive a `response.completed` event.	exception	error	responses, streaming, sse, incomplete-stream, python
Expected a non-empty value for `video_id` but received	validation	error	videos, path-parameter, validation, valueerror
not handled yet	exception	error	streaming, delta-accumulation, unsupported-shape, python
Could not find header	exception	error	valueerror, headers, mocking, compatibility
Expected a non-empty value for `group_id` but received	validation	error	openai-python, admin-api, validation, path-parameter, roles
Azure IMDS response did not include an access_token	exception	critical	azure, imds, managed-identity, auth
Encountered a message delta with no previous snapshot	exception	error	assistants, streaming, delta-accumulation, event-ordering, python
Expected a non-empty value for `project_id` but received	validation	error	openai-python, admin-api, validation, path-parameter, roles
Expected Chat Completions function tool shape to be created…	validation	error	responses, tools, chat-completions, migration, python
Expected a non-empty value for…	validation	error	python, openai, fine-tuning, permissions, path-parameter, valueerror
Invalid `http_client` argument; Expected an instance of…	exception	error	openai, uploads, content-length, typeerror, in-memory
No final run object found	exception	error	assistants, streaming, run, final-result, python
The token file at is empty.	exception	critical	kubernetes, workload-identity, auth, token-file
Refusing to authenticate a Bedrock request for an origin…	error_code	error	bedrock, aws, bearer, origin, base-url
MissingStreamClassError	exception	error	python, streaming, sse, client-configuration, missing-dependency
Subclasses of HTTP response classes cannot be passed to…	validation	error	cast-to, typing, httpx, response-parsing
model must be provided when creating a new response	validation	error	responses, stream, missing-argument, validation, python
To use the aiohttp client you must have installed the…	exception	error	aiohttp, extras, dependency, async, runtime-error
Bedrock SigV4 authentication does not support automatic…	error_code	error	bedrock, aws, sigv4, redirects
WebSocket error	exception	error	python, websocket, responses-api, event-handling, async
Pagination is only supported with mappings	exception	error	openai, vector-stores, file-batches, validation, valueerror, python
No run steps found	exception	warning	assistants, streaming, run-steps, python
Expected a non-empty value for `container_id` but received	validation	error	openai, python, validation, containers, path-parameter
The Bedrock endpoint region	error_code	error	bedrock, aws, region, config
Expected Content-Type response header to be…	validation	error	content-type, strict-validation, http, response
The Bedrock hostname does not match the selected ` `…	exception	error	bedrock, aws, sigv4, endpoint
Expected to be a dictionary; path=	validation	error	json-schema, pydantic, strict-mode, validation
No messages found	exception	warning	assistants, streaming, messages, python
`provider` cannot be combined with top-level	exception	error	provider, constructor, configuration, conflict
Pydantic models must subclass our base model type, e.g…	validation	error	pydantic, cast-to, typing, models
The Bedrock hostname does not match the selected ` `…	error_code	error	bedrock, aws, endpoint, config
max_retries cannot be None. If you want to disable retries…	exception	error	openai, vector-stores, file-batches, async, validation, python
Must provide one of the `base_url` or `azure_endpoint`…	validation	critical	azure, configuration, env-var, client-init
Giving up on waiting for file	exception	warning	files, timeout, polling, batch
Unexpected JSON data type	exception	error	openai, vector-stores, file-batches, async, validation, python
Async runtime is not supported yet. Only asyncio or trio is…	exception	error	asyncio, trio, runtime, upload-and-poll, vector-stores
"Could not resolve authentication method. Expected either…	validation	error	auth, headers, api-key, validation
Expected a non-empty value for `item_id` but received	validation	error	openai, conversations, items, retrieve, item-id, valueerror
Failed to resolve a bearer credential for Bedrock.	error_code	error	bedrock, aws, bearer, credentials
Bedrock SigV4 authentication requires a replayable request…	error_code	error	bedrock, aws, sigv4, streaming-body
Expected a non-empty value for `conversation_id` but…	validation	error	openai, conversations, items, path-parameter, valueerror
Unable to handle auth	validation	error	azure, internal-invariant, unreachable, subclassing
Expected a non-empty value for `call_id` but received	validation	error	realtime, parameter-validation, sync
Invalid `workload_identity` configuration: expected an…	exception	error	auth, workload-identity, x509, configuration, validation
No next page expected; please check `.has_next_page()`…	exception	error	openai, vector-stores, file-batches, pagination, validation, python
Expected a non-empty value for `run_id` but received	validation	error	openai, evals, value-error, path-parameter, client-side-validation
X.509 workload identity cannot be changed after client…	exception	error	auth, x509, workload-identity, immutability, rotation
Expected to have received `response.created` before	exception	error	streaming, responses, event-order
Cannot mix and match text.format with text_format	validation	error	responses, stream, text-format, conflicting-args, python
Currently only `function` tool types support auto-parsing…	validation	error	completions, tools, validation, parsing
Canonical Amazon Bedrock endpoints require HTTPS.	error_code	error	bedrock, aws, https, tls
Could not find credentials for Bedrock. Pass a bearer…	exception	error	bedrock, aws, credentials, env-var
Pass refreshable Bedrock credentials via…	exception	error	bedrock, authentication, api-key, aws, config
Refusing to sign a Bedrock request for an origin other than…	error_code	error	bedrock, aws, sigv4, origin, base-url
Passing raw bytes as `body` is deprecated and will be…	console	warning	deprecation, request-body, bytes, http
Received positional arguments which are not supported…	validation	error	python, validation, constructor, keyword-args
The `data_residency` and `base_url` arguments are mutually…	validation	error	data-residency, base-url, mutually-exclusive, constructor
Expected a non-empty value for `skill_id` but received	validation	error	skills, validation, path-parameter, argument-error
Invalid provider. Providers must be created by an OpenAI…	exception	error	python, provider, configuration, invalid-argument
An error occurred during streaming	exception	error	streaming, sse, api-error, error-payload
Expected a non-empty value for `file_id` but received	validation	error	openai, python, validation, containers, path-parameter
Passing both `files` and `content` is not supported	exception	error	openai, uploads, async, content-length, typeerror, in-memory
Expected a non-empty value for `user_id` but received	validation	error	openai, admin-api, validation, path-parameter, valueerror
Expected a non-empty value for `output_item_id` but received	validation	error	openai, evals, value-error, path-parameter, client-side-validation
The `api_key` and `workload_identity` arguments are…	exception	error	auth, workload-identity, api-key, configuration, conflict
You need to install `openai[realtime]` to use this method	exception	error	python, realtime, missing-dependency, optional-extra, websocket
Expected a non-empty value for `thread_id` but received	validation	error	python, openai, assistants, run-steps, thread-id, validation
Expected a non-empty value for `version` but received	validation	error	skills, versions, content, validation, path-parameter
Missing credentials. Please pass an `api_key`…	exception	critical	auth, api-key, env-var, credentials, constructor
Multipart request body must be a mapping	validation	error	python, multipart, request-body, validation
The Bedrock AWS `region` is invalid. Use a standard AWS…	error_code	error	bedrock, aws, region, config
An async Bedrock token provider requires `AsyncOpenAI`.	error_code	error	bedrock, aws, bearer, async, sync-mismatch
Value is not iterable	validation	error	pydantic, deserialization, schema-mismatch, validation