Skip to navigation

Manage applications

Requires applications.{action}. Changes are audited. Use the record ID for edit/delete and the application ID for app-scoped records. The route accepts POST with an action, not PUT or DELETE. Do not expose management keys in distributed SDKs or browser code.

Authentication

AuthorizationBearer

Account-level key with the exact resource.action permission and a supporting account plan.

Request

This endpoint expects an object.
actionenumOptionalDefaults to create
Allowed values:
appIdstringOptional

Application ID. Required for app-scoped changes.

idstringOptional
Record ID. Required for actions other than create.
daysintegerOptional1-365000

Duration for extend or shorten. Deferred/lifetime expiry cannot be extended or shortened.

valuesmap from strings to anyOptional

Fields for create/edit. Use name for app/identity/value names, subscription for an app plan name, expiryDays for duration or Lifetime, devices for device limit, and value for cloud variable content. Application creation requires name; version defaults to 1.0.0. License creation can omit name to generate a key; keyGroups/keyLength default to 4, each allows 3 to 5. Status changes require their own action permissions.

Response

Successful
okboolean
idstring
actionstring

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error