OMomni
User attributes

Switch an attribute value for the current user

Changed on

Switches a user attribute value for the calling user. The switch then drives dynamic shared extensions, access filters and connection environment routing exactly as an assigned value would.

To change what values a user can switch to, use the Set switchable values endpoint instead.

put/v1/user-attribute-selections

Request

  • Base URL
    https://blobsrus.omniapp.co/api
  • URL
    https://blobsrus.omniapp.co/api/v1/user-attribute-selections
  • Auth
    HTTP bearer

Request body

user_attribute_idstring required

Unique identifier for custom attributes. Empty string for system-defined attributes.

valuesstring[] 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.

Example request

{
  "user_attribute_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "values": [
    "acme",
    "globex"
  ]
}

Response

The caller's switchable attributes after the change

Example response

{
  "records": [
    {
      "user_attribute_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "region",
      "label": "Region",
      "selectable_values": [
        "acme",
        "globex"
      ],
      "selected_values": [
        "globex"
      ]
    }
  ]
}

Changes