PathTrack Firmware Admin

Publish a device-specific firmware image through the full upload and publish flow.

API Base URL

Admin Bearer Token

Device ID

Target Firmware Revision

Firmware Binary

Required API Contract

POST /admin/fota/upload-url returns upload_url and object_key.
POST /admin/fota/publish confirms the uploaded object and updates device assignment.
Authorization: Bearer ... is sent when a token is provided.

Validation

device_id must match ^[A-Za-z0-9][A-Za-z0-9_-]{2,63}$.
target_fw_rev must be a positive integer.
Only .bin uploads are accepted by the client.

Publish Sequence

Request upload URL from the admin API.
Upload the binary directly to S3 using the pre-signed URL.
Call publish API so the backend writes the device update record.