Skip to content

Product

Manage Products.

Download

Download device agent software.

Endpoint

HTTP
POST /product/download

Authorized User Role

user

Request Body

FieldTypeRequiredNotes
imagestringyesImage name.
planIdstringPlan ID.

Response

The download URL for the requested image.

Find

Get a list of products.

Endpoint

HTTP
POST /product/find

Authorized User Role

user

Request Body

FieldTypeNotes

Query String Options

FieldTypeDefaultNotes
indexstringIndex name: primary or gs1.
limitnumberLimit number of results.
nextobjectToken for next page.
prevobjectToken for previous page.

Response

Paged response.

FieldTypeNotes
dataarrayAn array of Product records.
nextstringPaged cursor to use for the next page of items.
prevstringPages cursor to use for the previous page of items.

Product

FieldTypeNotes
accountIdstringOwning account ID.
descriptionstringProduct description.
idstringProduct ID.
namestringProduct name.
planIdstringOwning plan ID.
suspendedbooleanProduct suspended.
urlstringProduct URL.

Get

Get a product definition by ID.

Endpoint

HTTP
POST /product/get

Authorized User Role

user

Request Body

FieldTypeRequiredNotes
idstringyesProduct ID.

Response

Product Record.

FieldTypeNotes
accountIdstringOwning account ID.
descriptionstringProduct description.
idstringProduct ID.
namestringProduct name.
planIdstringOwning plan ID.
suspendedbooleanProduct suspended.
urlstringProduct URL.

Update

Update a product definition.

Endpoint

HTTP
POST /product/update

Authorized User Role

admin

Request Body

FieldTypeNotes
advancebooleanPayment in advance.
alignbooleanAlign billing with plan period.
agentstringLicensed agent.
createddateCreated.
descriptionstringProduct description.
idstringProduct ID.
enddateEnd of plan period.
interestarrayAreas of interest.
namestringUnique simple name without spaces.
notifyarrayEmail addresses for product alerts.
pendingbooleanSuscription pending till user confirms.
periodstringPlan period.
planIdstringPlan ID.
scopestringLicense scope: product, family, business.
startdateStart of subscription plan.
typestringLicense type: volume, subscription, business, agreement.
unitsnumberNumber of devices for volume limited scriptions.
urlstringCompany website URL.

Response

Product Record.

FieldTypeNotes
accountIdstringOwning account ID.
descriptionstringProduct description.
idstringProduct ID.
namestringProduct name.
planIdstringOwning plan ID.
suspendedbooleanProduct suspended.
urlstringProduct URL.