Device
Activate device via user license or device serial number
Header parameters
AuthorizationstringOptionalPattern:
Provide only if activation via user license should be performed
Bearer .+
X-Session-IdstringOptionalPattern:
Leave out if no sessionId is known.
^[0-9a-f]{8}(?:-[0-9a-f]{4}){3}-[0-9a-f]{12}$
Body
licenseKeystringOptional
Responses
200
Device successfully activated
application/json
204
Device already active
403
Forbidden, e.g. no user license available
application/json
500
Internal Server Error
application/json
post
POST /api/v2/device/license/activate HTTP/1.1
Host: console.flecs.tech
Content-Type: application/json
Accept: */*
Content-Length: 21
{
"licenseKey": "text"
}
{
"data": {
"sessionId": {
"id": "text",
"timestamp": 1
},
"licenseKey": "text"
},
"statusCode": 1,
"statusText": "text"
}
Validate the device license based on the session id
Header parameters
X-Session-IdstringRequiredPattern:
^[0-9a-f]{8}(?:-[0-9a-f]{4}){3}-[0-9a-f]{12}$
Responses
200
Device successfully activated
application/json
500
Internal Server Error
application/json
post
POST /api/v2/device/license/validate HTTP/1.1
Host: console.flecs.tech
X-Session-Id: text
Accept: */*
{
"data": {
"isValid": true
},
"statusCode": 200,
"statusText": "OK"
}
Register a new device license with manufacturer and device details
Header parameters
AuthorizationstringRequiredPattern:
Bearer .+
Body
modelstringRequiredExample:
IPC-xyz
serial_numberstringRequiredExample:
Unique identifier for the device, must be globally unique across all devices
SN123456789
manufacture_datestring · dateRequiredExample:
ISO 8601 date format
2025-01-01
Responses
201
Device license created successfully
application/json
400
Bad request - Invalid payload
application/json
401
Unauthorized - Invalid or missing bearer token
application/json
422
Unprocessable Entity - Validation errors
application/json
500
Internal server error
application/json
post
POST /api/v2/device/license HTTP/1.1
Host: console.flecs.tech
Authorization: text
Content-Type: application/json
Accept: */*
Content-Length: 137
{
"manufacturer": {
"name": "Example Manufacturer",
"id": 791
},
"model": "IPC-xyz",
"serial_number": "SN123456789",
"manufacture_date": "2025-01-01"
}
{
"data": {
"manufacturer": {
"name": "Example Manufacturer",
"id": 791
},
"model": "IPC-xyz",
"serial_number": "SN123456789",
"manufacture_date": "2025-01-01",
"created_at": "2025-07-28T10:30:00.000Z",
"status": 0
},
"statusCode": 201,
"statusText": "Created"
}
Last updated
Was this helpful?