Deploy a device

POST

/devices/{id}/deploy

curl --request POST \
  --url https://app.buildtrace.eu/api/devices/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/deploy \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "fleetId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "deploymentLocation": "example", "customerName": "example" }'

Required scope: field:write.

Authorizations

• bearerAuth

Parameters

Path Parameters

id

required

string format: uuid

Request Body^required

Media typeapplication/json

object

fleetId

required

string format: uuid

deploymentLocation

string

customerName

string

Example ^generated

{
  "fleetId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "deploymentLocation": "example",
  "customerName": "example"
}

Responses

200

OK

Media typeapplication/json

object

id

required

string format: uuid

serialId

required

string format: uuid

fleetId

string format: uuid

serialNumber

The unit’s serial number (on listed and fetched devices).

string

deviceIdentifier

required

string

deploymentStatus

required

string

lastSeenAt

When the device last checked in; absent if it never has.

string format: date-time

connectionStatus

required

string

firmwareCompliant

required

boolean

deploymentLocation

string

customerName

string

Example ^generated

{
  "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "serialId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "fleetId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "serialNumber": "example",
  "deviceIdentifier": "example",
  "deploymentStatus": "example",
  "lastSeenAt": "2026-04-15T12:00:00Z",
  "connectionStatus": "example",
  "firmwareCompliant": true,
  "deploymentLocation": "example",
  "customerName": "example"
}

400

Bad request

Media typeapplication/json

object

error

required

string

Example ^generated

{
  "error": "example"
}

401

Unauthorized

404

Not found

409

Conflict (invalid transition)

Media typeapplication/json

object

error

required

string

Example ^generated

{
  "error": "example"
}