Discover Device Component

POST 
/api/v2/device/discover/component

This service message allows a device to post the discovery context for getting device software offers.

Request

application/json

Body

required

id string
snapshotDate string

Timestamp when the discovery snapshot was taken

deviceTypeToken string

Name or ID (as string) of the deviceType (e.g., router, switch, server, etc.), used for discovery of devices of type "device"

platform

object

token stringrequired

Name or ID (as string) of the platformType or system being discovered.

devices array

Array of devices discovered within this platform. Each device contains detailed discovery information of type "DiscoveryMessageV2Dto".

general

object

personalDevice

object

name string

idNumber string

personalNumber string

situationalDevice

object

weather number

bandwidth number

time date-time

operativeState boolean

power number

availableStorage string

location

object

lat stringrequired

long stringrequired

alt string

physicalDevice

object

MAC string

IP string

ID stringdeprecated

OS string

Possible values: [android, windows, linux, macos]

serialNumber string

possibleBandwidth string

availableStorage stringdeprecated
discoveryType stringrequired

Possible values: [get-app, get-map, mTls]

softwareData

object

formations string[]deprecated

platforms string[]deprecated

components

object[]

Array [

catalogId stringrequired

state stringrequired

Possible values: [offering, push, delivery, downloaded, deleted, deploy, installed, uninstalled]

error string

]

mapData

object

productId string

productName string

productVersion string

productType string

description string

boundingBox string

crs string

imagingTimeStart string

imagingTimeEnd string

creationDate string

source string

classification string

compartmentalization string

region string

sensor string

precisionLevel string

resolution string

inventory string[]

Responses

200

application/json

Schema

Schema

offer

object[]

required

Array [

id stringrequired

version stringrequired

projectName stringrequired

releaseNotes string

metadata object

status stringrequired

Possible values: [draft, in_review, approved, released, archived]

type stringrequired

Possible values: [product, formation]

size int64

createdAt date-timerequired

updatedAt date-timerequired

latest boolean

releasedAt date-time

]

push

object[]

required

Array [

id stringrequired

version stringrequired

projectName stringrequired

releaseNotes string

metadata object

status stringrequired

Possible values: [draft, in_review, approved, released, archived]

type stringrequired

Possible values: [product, formation]

size int64

createdAt date-timerequired

updatedAt date-timerequired

latest boolean

releasedAt date-time

]

Example (from schema)

{
  "offer": [
    {
      "id": "string",
      "version": "string",
      "projectName": "string",
      "releaseNotes": "string",
      "metadata": {},
      "status": "draft",
      "type": "product",
      "size": 0,
      "createdAt": "2026-01-01T11:09:06.630Z",
      "updatedAt": "2026-01-01T11:09:06.630Z",
      "latest": true,
      "releasedAt": "2026-01-01T11:09:06.630Z"
    }
  ],
  "push": [
    {
      "id": "string",
      "version": "string",
      "projectName": "string",
      "releaseNotes": "string",
      "metadata": {},
      "status": "draft",
      "type": "product",
      "size": 0,
      "createdAt": "2026-01-01T11:09:06.630Z",
      "updatedAt": "2026-01-01T11:09:06.630Z",
      "latest": true,
      "releasedAt": "2026-01-01T11:09:06.630Z"
    }
  ]
}

Loading...