{"record":{"id":"1c691009edae9025","repo":"openai/openai-python","slug":"expected-a-non-empty-value-for-response-id-but-r-1c6910","errorCode":null,"errorMessage":"Expected a non-empty value for `response_id` but received {response_id!r}","messagePattern":"Expected a non-empty value for `response_id` but received (.+?)","errorType":"validation","errorClass":"ValueError","httpStatus":null,"severity":"error","filePath":"src/openai/resources/responses/responses.py","lineNumber":1626,"sourceCode":"        ...\n\n    def retrieve(\n        self,\n        response_id: str,\n        *,\n        include: List[ResponseIncludable] | Omit = omit,\n        include_obfuscation: bool | Omit = omit,\n        starting_after: int | Omit = omit,\n        stream: Literal[False] | Literal[True] | Omit = omit,\n        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.\n        # The extra values given here take precedence over values defined on the client or passed to this method.\n        extra_headers: Headers | None = None,\n        extra_query: Query | None = None,\n        extra_body: Body | None = None,\n        timeout: float | httpx2.Timeout | None | NotGiven = not_given,\n    ) -> Response | Stream[ResponseStreamEvent]:\n        if not response_id:\n            raise ValueError(f\"Expected a non-empty value for `response_id` but received {response_id!r}\")\n        return self._get(\n            path_template(\"/responses/{response_id}\", response_id=response_id),\n            options=make_request_options(\n                extra_headers=extra_headers,\n                extra_query=extra_query,\n                extra_body=extra_body,\n                timeout=timeout,\n                query=maybe_transform(\n                    {\n                        \"include\": include,\n                        \"include_obfuscation\": include_obfuscation,\n                        \"starting_after\": starting_after,\n                        \"stream\": stream,\n                    },\n                    response_retrieve_params.ResponseRetrieveParams,\n                ),\n                security={\"bearer_auth\": True},\n            ),","sourceCodeStart":1608,"sourceCodeEnd":1644,"githubUrl":"https://github.com/openai/openai-python/blob/9917c6e28e66e90e1227b3d223c06a8c5441515a/src/openai/resources/responses/responses.py#L1608-L1644","documentation":"Raised by client.responses.retrieve() when response_id is empty (None, '', or falsy) before any HTTP request is made. The id is interpolated into the path /responses/{response_id}, so an empty value would produce a malformed URL; the SDK fails fast instead.","triggerScenarios":"client.responses.retrieve(response_id=None), retrieve(''), or retrieve(response_id='') where the id came from an unset variable or a response object whose .id was missing/empty.","commonSituations":"Accessing response.id on an object that doesn't have it (e.g. an error object or a stream event), passing an empty string from parsed JSON, typos like response_id='' defaults in wrappers.","solutions":["Verify the id is a non-empty string starting with 'resp_' before calling retrieve","Trace where response_id came from — usually a previous response object or stored job id","If reading from storage/API output, add a guard clause for falsy values"],"exampleFix":"// before\nresp = client.responses.retrieve(response_id=data.get(\"id\"))\n// after\nrid = data.get(\"id\") or \"\"\nresp = client.responses.retrieve(response_id=rid) if rid else None","handlingStrategy":"validation","validationCode":"rid = response_id if isinstance(response_id, str) and response_id.strip() else None\nif not rid:\n    raise ValueError(f'cannot retrieve response with empty id: {response_id!r}')\nresp = client.responses.retrieve(response_id=rid)","typeGuard":"def is_valid_response_id(rid) -> bool:\n    return isinstance(rid, str) and bool(rid.strip())","tryCatchPattern":"try:\n    resp = client.responses.retrieve(response_id=rid)\nexcept ValueError as e:\n    if 'non-empty value' in str(e):\n        rid = fallback_id or fetch_latest_id()\n        if rid:\n            resp = client.responses.retrieve(response_id=rid)\n        else:\n            raise\n    else:\n        raise","preventionTips":["Guard all retrieve calls with a truthiness check on the id","Validate ids parsed from external payloads (webhooks, DB rows)","Log when an expected id is missing rather than passing it through"],"tags":["responses","retrieve","empty-argument","validation","python"],"backgroundTag":"missing-required-parameter","analyzedSha":"9917c6e28e66e90e1227b3d223c06a8c5441515a","analyzedAt":"2026-08-28T11:46:34.183Z","schemaVersion":2},"datasetVersion":"2026-08-28T16:17:29.566Z"}