Sign in
User Attributes

Switch an attribute for the calling user

Switches an attribute for the calling user. Every value must already be provisioned for them unless an administrator allowed any value for that attribute, so this cannot grant access that an administrator has not granted. The switch then drives dynamic shared extensions, access filters and connection environment routing exactly as an assigned value would.

put/api/v1/user-attribute-selections

Request body

user_attribute_idstring uuid required

The attribute definition to switch

valuesstring[] required

Values to switch to. Every value must be provisioned for the calling user unless the attribute allows any value for them, and a single-valued attribute accepts exactly one. At most 300 values.

Example request

{
  "values": [
    "globex"
  ]
}

Response

The caller's switchable attributes after the change

Example response

{
  "records": [
    {
      "label": "Client",
      "name": "client",
      "selectable_values": [
        "acme",
        "globex"
      ],
      "selected_values": [
        "globex"
      ]
    }
  ]
}

Changes

Changed in 1 of the 46 revisions of this API.1