{"record":{"id":"7733913eeeb063f5","repo":"openai/openai-python","slug":"expected-a-non-empty-value-for-user-id-but-recei-773391","errorCode":null,"errorMessage":"Expected a non-empty value for `user_id` but received {user_id!r}","messagePattern":"Expected a non-empty value for `user_id` but received (.+?)","errorType":"validation","errorClass":"ValueError","httpStatus":null,"severity":"error","filePath":"src/openai/resources/admin/organization/projects/users/roles.py","lineNumber":76,"sourceCode":"    ) -> RoleCreateResponse:\n        \"\"\"\n        Assigns a project role to a user within a project.\n\n        Args:\n          role_id: Identifier of the role to assign.\n\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 project_id:\n            raise ValueError(f\"Expected a non-empty value for `project_id` but received {project_id!r}\")\n        if not user_id:\n            raise ValueError(f\"Expected a non-empty value for `user_id` but received {user_id!r}\")\n        return self._post(\n            path_template(\"/projects/{project_id}/users/{user_id}/roles\", project_id=project_id, user_id=user_id),\n            body=maybe_transform({\"role_id\": role_id}, role_create_params.RoleCreateParams),\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=RoleCreateResponse,\n        )\n\n    def retrieve(\n        self,\n        role_id: str,\n        *,\n        project_id: str,","sourceCodeStart":58,"sourceCodeEnd":94,"githubUrl":"https://github.com/openai/openai-python/blob/9917c6e28e66e90e1227b3d223c06a8c5441515a/src/openai/resources/admin/organization/projects/users/roles.py#L58-L94","documentation":"The sync Roles.create method validates user_id in addition to project_id before POSTing to /projects/{project_id}/users/{user_id}/roles. An empty user_id raises this ValueError client-side; no role assignment request is made.","triggerScenarios":"Calling roles.create(..., user_id='', role_id='role_...') where the user id is blank, None, or a defaulted empty string.","commonSituations":"Looking up a user by email, failing to find them, and passing the empty result as user_id; or form input where the user field was left blank.","solutions":["Resolve the user_id (e.g. 'user-...') from client.admin.users.list or your identity store before assigning a role","Guard: if not user_id: skip/log instead of calling create"],"exampleFix":"// before\nroles.create(project_id=project_id, user_id=\"\", role_id=role_id)\n// after\nuser = next(u for u in client.admin.users.list() if u.email == email)\nroles.create(project_id=project_id, user_id=user.id, role_id=role_id)","handlingStrategy":"validation","validationCode":"if not user_id or not user_id.strip():\n    raise ValueError(\"user_id required\")\nclient.admin.organization.projects.users.roles.create(project_id=project_id, user_id=user_id, role_id=role_id)","typeGuard":"def is_valid_user_id(value: object) -> bool:\n    return isinstance(value, str) and bool(value.strip()) and not value.isspace()","tryCatchPattern":"try:\n    roles.create(project_id, user_id, role_id)\nexcept ValueError as e:\n    if \"user_id\" in str(e):\n        return None  # skip this user\n    raise","preventionTips":["Never pass the result of a failed user lookup","Check user_id from forms/CLI args before assignment"],"tags":["openai","admin-api","rbac","validation","path-parameter"],"backgroundTag":"missing-required-parameter","analyzedSha":"9917c6e28e66e90e1227b3d223c06a8c5441515a","analyzedAt":"2026-08-28T11:46:34.183Z","schemaVersion":2},"datasetVersion":"2026-08-28T16:17:29.566Z"}