openai/openai-python · error · ValueError

Expected a non-empty value for `group_id` but received {grou

Error message

Expected a non-empty value for `group_id` but received {group_id!r}

What it means

Adding a user to a group (users.py:73) requires a non-empty group_id for POST /organization/groups/{group_id}/users; a falsy value raises ValueError before the user_id body is transformed. This is the same generated guard pattern applied to the users nested resource.

Source

Thrown at src/openai/resources/admin/organization/groups/users.py:73

        extra_body: Body | None = None,
        timeout: float | httpx2.Timeout | None | NotGiven = not_given,
    ) -> UserCreateResponse:
        """
        Adds a user to a group.

        Args:
          user_id: Identifier of the user to add to the group.

          extra_headers: Send extra headers

          extra_query: Add additional query parameters to the request

          extra_body: Add additional JSON properties to the request

          timeout: Override the client-level default timeout for this request, in seconds
        """
        if not group_id:
            raise ValueError(f"Expected a non-empty value for `group_id` but received {group_id!r}")
        return self._post(
            path_template("/organization/groups/{group_id}/users", group_id=group_id),
            body=maybe_transform({"user_id": user_id}, user_create_params.UserCreateParams),
            options=make_request_options(
                extra_headers=extra_headers,
                extra_query=extra_query,
                extra_body=extra_body,
                timeout=timeout,
                security={"admin_api_key_auth": True},
            ),
            cast_to=UserCreateResponse,
        )

    def retrieve(
        self,
        user_id: str,
        *,
        group_id: str,

View on GitHub (pinned to 9917c6e28e)

Solutions

1. Resolve both group_id and user_id from authoritative sources before the call
2. Validate both are non-empty strings in a pre-flight check
3. Store group/user ID mappings in one validated config

Example fix

# before
client.admin.organization.groups.users.create(group_id=gid, user_id=uid)

# after
if not gid or not uid:
    raise ValueError(f'need group_id and user_id, got {gid!r}, {uid!r}')
client.admin.organization.groups.users.create(group_id=gid, user_id=uid)

if not group_id or not user_id:
    raise ValueError(f'need group_id and user_id, got {group_id!r}, {user_id!r}')
client.admin.organization.groups.users.create(group_id=group_id, user_id=user_id)

def are_valid_ids(*ids: object) -> bool:
    return all(isinstance(i, str) and i.strip() for i in ids)

When it happens

Trigger: client.admin.organization.groups.users.create(group_id='', user_id='user_1'); typical when the group ID and user ID come from different sources and one is missing.

Common situations: Onboarding automation adding users to groups where the group env var is unset; CSV imports with blank group columns.

Understand the failure class

Background: Missing required parameter errors: what 'X is required' and 'the required X param is missing' mean, and how to fix them — this error's family across 27 libraries.

Related errors

• Expected a non-empty value for `group_id` but received {grou
• Expected a non-empty value for `group_id` but received {grou
• Expected a non-empty value for `user_id` but received {user_
• Expected a non-empty value for `role_id` but received {role_
• Expected a non-empty value for `user_id` but received {user_

AI-assisted analysis of openai/openai-python@9917c6e28e (2026-08-28). Data as JSON: /api/errors/04cbd8720167eef0. Report an issue: GitHub.