Create key
POST/keys
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.
| Code | Type | Description |
|---|---|---|
assetsNotFound | Unknown object | [assetId] not found. |
operatorsNotFound | Unknown object | [operatorId] not found. |
groupsNotFound | Unknown object | [groupId] not found. |
sitesNotFound | Unknown object | [siteId] not found. |
accountOperatorKeysNotAllowed | Business rule violation | [operatorId] cannot be assigned digital keys or rolling PINs due to account restrictions. |
conflictingKey | Business rule violation | Existing key with overlapping time, same asset/group/site/fleet, and identical key card or static PIN. |
conflictType | Business rule violation | "non-customer specific access already exists" – generic non-customer key blocks specific customer key. "similar access already exists" – similar key already exists. |
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 500
Key has been created successfully. Newly created key.
Bad request
Invalid or missing bearer token in Authorization header
User not allowed to make this request
Resource not found
Internal server error