Update All User Apps

Updates all the application entitlements for a particular user.

Update the application entitlements for this user

post

/v1/admin/user/{uid}/app/entitlement/list

Path parameters

uidinteger · int64required

User ID as a decimal integer

Header parameters

sessionTokenstringrequired

Session authentication token.

Body

appIdstring · min: 1 · max: 256required

Unique ID for the Application

Example: selerity

appNamestring · min: 1 · max: 50

Name for this Application

Example: Selerity Context

listedbooleanrequired

if true, this application will be listed in the appstore for this user. Otherwise, this application will be hidden in the appstore.

Example: true

installbooleanrequired

if true, it indicate this application is installed for this user. Otherwise, this user does not have this application installed.

Example: true

productsobject[]

Example: [{"appId":"selerity","name":"Standard","subscribed":true,"type":"default"},{"appId":"selerity","name":"Premium","sku":"AcDccU53SsY","subscribed":false,"type":"premium"}]

Responses

application/json

application/json

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'yourpodURL.symphony.com/pod/v1/admin/user/{uid}/app/entitlement/list' \
  --header 'sessionToken: text' \
  --header 'Content-Type: application/json' \
  --data '[{"appId":"djApp","appName":"Dow Jones","listed":true,"install":false},{"appId":"selerity","appName":"Selerity Context","listed":true,"install":true,"products":[{"appId":"selerity","name":"Standard","subscribed":true,"type":"default"},{"appId":"selerity","name":"Premium","sku":"AcDccU53SsY","subscribed":false,"type":"premium"}]}]'

200

400

401

403

500

200

[
  {
    "appId": "djApp",
    "appName": "Dow Jones",
    "listed": true,
    "install": false
  },
  {
    "appId": "selerity",
    "appName": "Selerity Context",
    "listed": true,
    "install": true,
    "products": [
      {
        "appId": "selerity",
        "name": "Standard",
        "subscribed": true,
        "type": "default"
      },
      {
        "appId": "selerity",
        "name": "Premium",
        "sku": "AcDccU53SsY",
        "subscribed": false,
        "type": "premium"
      }
    ]
  }
]

Success

As shown in the example, the updated user application entitlements should be included in the data parameter.

❗️ Important

Please, consider the following information before using this endpoint:

The endpoint is designed to update all app entitlements of a user using a single API call. It is not meant to modify one single entitlement for a user.

However, it is possible to do this using the Patch Update User Apps endpoint.