{"record":{"id":"e54d2f4867f36aa6","repo":"openai/openai-python","slug":"expected-a-non-empty-value-for-role-id-but-recei-e54d2f","errorCode":null,"errorMessage":"Expected a non-empty value for `role_id` but received {role_id!r}","messagePattern":"Expected a non-empty value for `role_id` but received (.+?)","errorType":"validation","errorClass":"ValueError","httpStatus":null,"severity":"error","filePath":"src/openai/resources/admin/organization/roles.py","lineNumber":120,"sourceCode":"        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    ) -> Role:\n        \"\"\"\n        Retrieves an organization role.\n\n        Args:\n          extra_headers: Send extra headers\n\n          extra_query: Add additional query parameters to the request\n\n          extra_body: Add additional JSON properties to the request\n\n          timeout: Override the client-level default timeout for this request, in seconds\n        \"\"\"\n        if not role_id:\n            raise ValueError(f\"Expected a non-empty value for `role_id` but received {role_id!r}\")\n        return self._get(\n            path_template(\"/organization/roles/{role_id}\", role_id=role_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                security={\"admin_api_key_auth\": True},\n            ),\n            cast_to=Role,\n        )\n\n    def update(\n        self,\n        role_id: str,\n        *,\n        description: Optional[str] | Omit = omit,\n        permissions: Optional[SequenceNotStr[str]] | Omit = omit,","sourceCodeStart":102,"sourceCodeEnd":138,"githubUrl":"https://github.com/openai/openai-python/blob/9917c6e28e66e90e1227b3d223c06a8c5441515a/src/openai/resources/admin/organization/roles.py#L102-L138","documentation":"The SDK guards required path parameters before making a request. Admin organization roles retrieve requires a non-empty `role_id`; an empty value would request /organization/roles/ (the list endpoint) instead of a specific role. This ValueError is raised locally with no network traffic.","triggerScenarios":"Calling client.admin.organization.roles.retrieve(role_id='') or role_id=None, typically from an unset config value or empty lookup result.","commonSituations":"Role ID stored in config/env and missing; chaining retrieve after a search that returned no matches.","solutions":["Supply the actual role ID string (role_...)","Verify the variable is populated before calling retrieve()","Default or skip the call when the lookup source is empty"],"exampleFix":"// before\nrole = client.admin.organization.roles.retrieve(role_id=os.getenv(\"ROLE_ID\"))\n// after\nrole_id = os.environ[\"ROLE_ID\"]\nrole = client.admin.organization.roles.retrieve(role_id=role_id)","handlingStrategy":"validation","validationCode":"if not role_id:\n    roles = client.admin.organization.roles.list()\n    role_id = next(r.id for r in roles if r.name == ROLE_NAME)","typeGuard":"def is_valid_role_id(v) -> bool:\n    return isinstance(v, str) and v.startswith(\"role_\") and len(v) > 5","tryCatchPattern":"try:\n    role = client.admin.organization.roles.retrieve(role_id=role_id)\nexcept ValueError as e:\n    if \"role_id\" in str(e):\n        role_id = resolve_role_by_name()\n    else:\n        raise","preventionTips":["Resolve role IDs by name via list() when config may be stale","Fail fast on missing config keys at startup"],"tags":["openai","python","admin-api","roles","path-parameter","valueerror"],"backgroundTag":"missing-required-parameter","analyzedSha":"9917c6e28e66e90e1227b3d223c06a8c5441515a","analyzedAt":"2026-08-28T11:46:34.183Z","schemaVersion":2},"datasetVersion":"2026-08-28T16:17:29.566Z"}