---
title: "List the caller's switchable attributes"
method: GET
path: "/api/v1/user-attribute-selections"
tags: ["User Attributes"]
---

# List the caller's switchable attributes

`GET /api/v1/user-attribute-selections`

Returns the attributes the calling user may switch, with whichever switch is currently active. Empty when nothing is provisioned for them; an organization admin gets every attribute with allow_any_value true. Acts as the authenticated user; organization API keys act as the key's creator.

## Response `200`

The caller's switchable attributes and active switches

- UserAttributeSelectionsResponse
  - `records` object[], required — Attributes the calling user may switch. Empty when nothing is provisioned for them; an organization admin gets every attribute with allow_any_value true.
    - `allow_any_value` boolean, required — Whether the caller may switch to a value that is not listed; selectable_values are then suggestions
    - `label` string, required — Display name of the attribute
    - `multiple_values` boolean, required — Whether the attribute accepts an array of values
    - `name` string, required — Reference name used in model SQL
    - `selectable_values` string[], required — The listed values; when allow_any_value is true, up to 200 suggestions drawn from values assigned in the organization
    - `selected_values` string[], nullable, required — The active switch, or null when the assigned value applies
    - `user_attribute_id` string, uuid, required — The attribute definition id

## Other responses

- `401` — Authentication required

## Changes

- **2026-09-30** `299eacbcab4d` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/omniapp/apis/omni-api/changes/api/v1/user-attribute-selections/get.md)

---

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