Management API
License
Update License
4min
updates a single license, if requesting manager has access permissions to it when updating valid duration , validity period and trial days you should also send the is trial field when updating maintenance duration or maintenance period you should send the enable maintenance period field valid duration and validity period can't be sent is same update license request url /api/v1/licenses/{id}/ method patch parameters max activations integer max consumptions integer allow overages boolean max overages integer reset consumption boolean consumption period string choices daily , weekly , monthly , annualy is trial boolean trial days integer enable maintenance period boolean maintenance duration string choices examples 35d (35 days), 4m (4 months), 2y (2 years) is floating boolean is floating cloud boolean floating users integer valid duration string choices examples 35d (35 days), 4m (4 months), 2y (2 years) validity period date format yyyy mm dd (2020 09 30) prevent vm boolean note string max license users integer default 0 (unlimited) floating timeout integer max transfers integer default 0 (unlimited) allow unlimited activation boolean order integer "metadata" json object allow grace period boolean grace period integer installation file integer data example { "max activations" 5 } success response code 200 ok content examples { "id" 1593781720493289, "status" "inactive", "floating in use devices" 0, "customer" { "id" 620, "total orders" 14, "total licenses" 45, "labels" \[ { "id" 3, "label id" 8, "label" "customer", "color" "#ff9f43" }, { "id" 53, "label id" 34, "label" "loyal", "color" "#3a0cd4" } ], "email" "tc\@tc com", "first name" "", "last name" "", "company name" "", "phone" "", "reference" "", "address" "", "postcode" "", "city" "", "country" "", "state" "", "cognito user pool id" "", "metadata" {}, "clabels all" "customerloyal", "company" 277, "license user" null, "clabels" \[ 8, 34 ] }, "product features" \[ { "id" 1596179495925542, "product feature" { "id" 173, "created at" "2020 09 14t11 17 43z", "updated at" "2020 09 14t11 17 43z", "name" "feature 3", "code" "f3", "is deleted" false, "feature type" "consumption", "max consumption" 2, "allow overages" false, "max overages" 0, "reset consumption" false, "consumption period" null }, "max consumption" 30, "total consumptions" 0, "expiry date" null, "allow overages" false, "max overages" 99, "reset consumption" false, "consumption period" null, "metadata" {} } ], "product custom fields" \[], "license users" \[ { "id" 1240, "last login" null, "email" "example\@email com|uss1", "true email" "example\@email com", "created at" "2020 08 12t08 52 32z", "updated at" "2020 08 12t09 01 24z", "is admin" {}, "is active" true, "is staff" false, "first name" "john", "last name" "doe", "phone number" "00385913109161", "subscribed to email" false, "acquired consent" null, "is manager" false, "initial password" "4q3dg7! ", "is initial password" true } ], "order store id" "d2d2dce02c844d4492c9d48758aa143a", "active up to date devices" 0, "total active devices" 0, "product" { "id" 1584723961091234, "product name" "mch" }, "created at" "2020 07 03t13 08 40z", "updated at" "2020 11 13t07 38 16 788576z", "license key" null, "active" false, "enabled" true, "time activated" "2020 10 10t14 42 16z", "time disabled" "2020 08 14t07 26 27z", "max activations" 5, "times activated" 0, "valid duration" null, "validity period" "2020 09 30", "license type" "perpetual", "enable maintenance period" true, "maintenance duration" "3m", "maintenance period" "2021 01 10", "is trial" true, "max consumptions" 0, "total consumptions" 0, "subscription id" null, "last check" null, "prevent vm" true, "allow overages" false, "max overages" 0, "reset consumption" false, "consumption period" null, "trial days" 0, "is floating" false, "is floating cloud" true, "floating users" 1, "note" null, "max license users" 0, "transfer count" 0, "floating timeout" null, "max transfers" 0, "is air gapped" false, "can borrow" false, "max borrow time" 0, "is bundle" false, "metadata" {}, "order" 1593781720493279, "order item" 1593781720493299, "disabled user" null, "last activation device" null }