Skip to main content

Get device offering

GET 
/api/v2/device/offering

Returns the software offerings available to this device, grouped by project. Each project contains one or more releases with policy availability information. When include_updates is enabled, releases that are currently downloading, deploying, or already installed are included with their real-time status.

Request​

Query Parameters

    bypass_policy boolean

    Skip policy enforcement; availability will be null on all releases

    include_updates boolean

    Include releases that are currently being delivered, deployed, or already installed on the device.

    When false (default), only available offerings are returned

    When true, the response also includes releases that are in progress (downloading, deploying, etc.) or already installed, alongside any available offerings.

    offering_mode OfferingMode

    Possible values: [download, install]

    Offering scope when this device is 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 for any device.
    • install: returns only offerings explicitly defined for this device's own platform and device types — what is actually applicable to install on this device.

Responses​

Schema

  • 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

  • ]

Loading...