---
title: "Set switchable values for a user or group"
method: PUT
path: "/v1/user-attributes/{userAttributeId}/selectable-values"
tags: ["User attributes"]
---

# Set switchable values for a user or group

`PUT /v1/user-attributes/{userAttributeId}/selectable-values`

## Request

- Base URL: `https://blobsrus.omniapp.co/api`
- URL: `https://blobsrus.omniapp.co/api/v1/user-attributes/{userAttributeId}/selectable-values`
- Auth: HTTP bearer

<Note>
  **Organization Admin** permissions are required to use this endpoint.
</Note>

Replaces the values a user or group may switch this attribute to. Values are validated against the attribute type, such as `String`.

Provide one of `user_id` or `group_id`; providing both will result in an error.

<Warning>
  Provisioning a value grants data access. Shared extensions and access filters often route on the same attribute, so a switchable value typically lets the user read another tenant's rows. Provision only the values a user or group should see.
</Warning>

## Path parameters

- `userAttributeId` string, uuid, required

## Request body

- union
  - object
    - `user_id` string, uuid, required: The user's membership ID, not their user ID. Mutually exclusive with `group_id`.
    - `values` string[], required: Values this user or group can switch the attribute to, validated against the attribute type. Numbers are sent as strings to preserve precision beyond `2^53`. At most 300 values of up to 512 characters each.
    - `allow_any_value` boolean: Whether the user or group can switch to a value that is not listed. When `true`, `selectable_values` are suggestions.
  - object
    - `group_id` string, required: The user group's mini UUID (short ID), matching the ID returned by the [List user groups](/api/user-groups/list-user-groups) endpoint. Mutually exclusive with `user_id`.
    - `values` string[], required: Values this user or group can switch the attribute to, validated against the attribute type. Numbers are sent as strings to preserve precision beyond `2^53`. At most 300 values of up to 512 characters each.
    - `allow_any_value` boolean: Whether the user or group can switch to a value that is not listed. When `true`, `selectable_values` are suggestions.

## Response `200`

The provisioning as stored

- SelectableValuesResponse
  - `user_attribute_id` string, required: Unique identifier for custom attributes. Empty string for system-defined attributes.
  - `values` string[], required: Values this user or group can switch the attribute to. Numbers are returned as strings to preserve precision beyond `2^53`.
  - `allow_any_value` boolean, required: Whether the user or group can switch to a value that is not listed. When `true`, `selectable_values` are suggestions.

## Other responses

- `400`: Bad Request. Both or neither of `user_id` and `group_id` were provided, the body failed validation, or a value is not valid for the attribute's type.
- `401`: Authentication required
- `403`: Forbidden. Requires Organization Admin permissions.
- `404`: Not Found. The user attribute definition, user, or group does not exist in the caller's organization.
- `405`: Method Not Allowed - Invalid HTTP method for this endpoint
- `429`: Too Many Requests - Rate limit exceeded (60 requests/minute)
- `500`: Internal Server Error

## Changes

- **2026-11-03** `43290040f88f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/omni/apis/omni-api/changes/v1/user-attributes/:userAttributeId/selectable-values/put.md)

---

[API](https://skmtc.dev/omni/apis/omni-api.md) - [All operations](https://skmtc.dev/omni/apis/omni-api/llms.txt) - [OpenAPI document](https://skmtc.dev/omni/apis/omni-api/revisions/43290040f88f?raw)