Create key

The "Create Key" endpoint generates a single access key for various access methods and target scopes, allowing you to define a time period during which the key is active.

This key is used to secure and control access to assets within the system.

Access keys can be created for individual operators, asset groups, entire sites, or entire fleets of assets, with the option to specify an active time window for the key.

May return constraint violations if access requests:

  • Break mandatory business rules.
  • Reference non-existent objects.
CodeTypeDescription
assetsNotFoundUnknown object[assetId] not found.
operatorsNotFoundUnknown object[operatorId] not found.
groupsNotFoundUnknown object[groupId] not found.
sitesNotFoundUnknown object[siteId] not found.
accountOperatorKeysNotAllowedBusiness rule violation[operatorId] cannot be assigned digital keys or rolling PINs due to account restrictions.
conflictingKeyBusiness rule violationExisting key with overlapping time, same asset/group/site/fleet, and identical key card or static PIN.
conflictTypeBusiness rule violation"non-customer specific access already exists" – generic non-customer key blocks specific customer key.
"similar access already exists" – similar key already exists.

➡️

OpenAPI Specification for the Access Management API domain

Get the OpenAPI Specification (formerly Swagger), which is a standardized format that describes the functionalities, endpoints, parameters, and data models of this API in a JSON file here.

Language
Credentials
Bearer
JWT
Click Try It! to start a request and see the response here!