Previous topic

Commands

Next topic

Devices

This Page

Device Enrollment Programmes

Summary

GET /api/v1/dep/profiles/

Retrieve a collection of objects

POST /api/v1/dep/profiles/

Create an object

GET /api/v1/dep/accounts/

Retrieve a collection of objects

POST /api/v1/dep/accounts/

Create an object

GET /dep/certificate/download

Create a new key/certificate to upload to the DEP/ASM/ABM portal.

The private key generated for this certificate will be the key recipient of the DEP S/MIME payload.

POST /dep/stoken/upload

Upload the smime.p7m supplied from the DEP, ASM or ABM portals and decrypt it with a matching private key from our database, storing the result in the dep_configurations table.

Request Headers:
 
Status Codes:
GET /dep/anchor_certs

Download a list of certificates to trust the MDM

The response is a JSON array of base64 encoded DER certs as described in the DEP profile creation documentation.

POST /dep/enroll

Accept a CMS Signed DER encoded XML data containing device information.

This starts the DEP enrollment process. The absolute url to this endpoint should be present in the DEP profile’s enrollment URL.

The signed data contains a plist with the following keys:

UDID:The device’s UDID.
SERIAL:The device’s Serial Number.
PRODUCT:The device’s product type: e.g., iPhone5,1.
VERSION:The OS version installed on the device: e.g., 7A182.
IMEI:The device’s IMEI (if available).
MEID:The device’s MEID (if available).
LANGUAGE:The user’s currently-selected language: e.g., en.
See Also:
GET /api/v1/dep/profiles/(int: dep_profile_id)/relationships/devices

Get a relationship details

POST /api/v1/dep/profiles/(int: dep_profile_id)/relationships/devices

Add / create relationship(s)

DELETE /api/v1/dep/profiles/(int: dep_profile_id)/relationships/devices

Delete relationship(s)

PATCH /api/v1/dep/profiles/(int: dep_profile_id)/relationships/devices

Update a relationship

GET /api/v1/dep/profiles/(int: dep_profile_id)

Get object details

DELETE /api/v1/dep/profiles/(int: dep_profile_id)

Delete an object

PATCH /api/v1/dep/profiles/(int: dep_profile_id)

Update an object

GET /api/v1/dep/accounts/(int: dep_account_id)

Get object details

DELETE /api/v1/dep/accounts/(int: dep_account_id)

Delete an object

PATCH /api/v1/dep/accounts/(int: dep_account_id)

Update an object