Skip to main content

Get software offering for acted devices

GET 
/api/cdn/device/offering

Returns one ProjectOfferingDto list per CDN-connected device, grouped by project. Each release includes availability based on that device's own platform, device-type, and runtime metadata (battery, OS, storage) stored in the discovery table. By default returns only active devices (?device_status=active). Use ?device_mode=orchestrated, ?device_mode=reactive, or ?device_mode=both to filter by device flags. When ?device_mode= is set, add ?device_connectivity=online or ?device_connectivity=offline to further filter by heartbeat TTL.

Request​

Query Parameters

    device_id string[]

    Repeated device ID filter: ?device_id=id1&device_id=id2. Omit to return all.

    device_status any

    Device status filter: active (default), inactive, or all.

    device_mode any

    Device mode filter: orchestrated (ORCHESTRATE_ME flag), reactive (REACTIVE_MODE flag), or both. Omit for no mode filter.

    device_connectivity any

    Device connectivity filter (only applied when ?device_mode= is set): online (active SSE subscription on ManagedCommand channel), offline (not subscribed), or both.

    bypass_policy boolean

    Skip policy enforcement; availability will be null on all releases.

    include_updates boolean

    Include releases already in the delivery/deploy pipeline.

    offering_mode any

    Offering scope for devices configured with the universal platform token.

    • download (default): returns all offerings available across all platforms and device types recorded in the DB — the full downloadable catalog.
    • install: returns only offerings applicable to this device's own platform and device types.

Responses​

Per-device project-grouped offerings. Policy and restriction evaluation uses each device's own metadata from the discovery table. Pass device_id to limit to specific devices.

Schema

  • Array [

    • data

    object[]

    required

    v2-typed payload for this device.

  • Array [

    • applicationCategory stringnullable

    Application category (user or technician)

    displayName stringnullable

    Display name of the project

    label stringnullable

    Label of the project

    projectId int64required

    Identifier of the project

    projectName stringrequired

    Name of the project

    releases object[]required

    All releases offered for this project

    tagline stringnullable

    Short one-line summary of the project

    tags string[]nullable

    Tags of the project

  • ]

    • dataWarning stringnullable

    Warning message indicating the data field may be incomplete or unreliable. When present, surface it visibly to the user.

    deviceId stringrequired

    Device identifier — matches the deviceId in CDN discovery.

    isMaster booleanrequired

    true when this entry represents the local CDN master agent itself.

    isOnline booleanrequired

    true when the device has an active SSE subscription on the ManagedCommand channel.

  • ]

Loading...