Skip to main content
PUT
/
entitlements
/
{id}
/
status
cURL
curl -X PUT \
 /entitlements/{id}/status \
 --header "Content-Type: application/json" \
 --header "Authorization: Bearer <token>" \
 --data '{
    "active": ""
}'
{
  "id": "<string>",
  "subscriptionItem": {
    "id": "01F9ZQZJZJQZJZJZJZJZJZJZJZ",
    "name": "Fitness M",
    "description": "Everything included",
    "furtherInformation": "Additional agreements: The contract includes a free drink flatrate.",
    "status": "active",
    "subscriptionId": "<string>"
  },
  "feature": {
    "id": "feature-1",
    "name": "number of users",
    "description": "This feature allows you to manage the number of users in your account.",
    "status": "active",
    "type": "switch",
    "config": [
      {
        "value": "<string>",
        "label": "<string>"
      }
    ],
    "unit": "<string>"
  },
  "value": "true",
  "validFrom": "2023-11-07T05:31:56Z",
  "validUntil": "2023-11-07T05:31:56Z",
  "active": true
}

Authorizations

​
Authorization
string
header
required

Value for the Authorization header parameter.

Path Parameters

​
id
string
required

Entitlement identifier

Body

The updated Entitlement resource

​
active
boolean

The status of the entitlement

Response

Entitlement resource updated

Get all entitlements of a subscription

​
id
string
​
subscriptionItem
object
​
feature
object
​
value
string

The value of the entitlement. Can be a boolean (switch), a string (custom), a number (quantity) or a custom number (range).

Example:

"true"

​
validFrom
string<date-time> | null

The date from which the entitlement is valid

​
validUntil
string<date-time> | null

The date until which the entitlement is valid

​
active
boolean