Update device common details (partial update)

patch

https://{region}.api.jamfcloud.com/pro/v1/mdm-renewal/device-common-details

Partially updates existing device common details. The clientManagementId must be provided in the request body to identify which record to update. Only updates fields that are explicitly provided in the request - missing fields preserve their existing values. Only updates existing records; does not create new ones.

Required Permissions: device-actions:execute

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

clientManagementId

string

required

The client management ID associated with this device (required)

renewMdmProfileStartDate

date-time | null

Timestamp when MDM profile renewal started (ISO 8601 format)

mdmProfileNeedsRenewalDueToCaRenewed

boolean | null

Whether the MDM profile needs renewal due to CA renewal

mdmProfileNeedsRenewalDueToDeviceIdentityCertExpiring

boolean | null

Whether the MDM profile needs renewal due to expiring device identity certificate

mdmCheckinUrl

string | null

URL for MDM check-in

mdmServerUrl

string | null

URL for MDM server

Headers

X-Tenant-Id

uuid

^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$

The tenant UUID identifier. Send it to address tenant scope. This API is also published at environment scope — send that scope's header instead. Send exactly one scope header per request.

X-Environment-Id

uuid

^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$

The environment UUID identifier. Send it to address environment scope. This API is also published at tenant scope — send that scope's header instead. Send exactly one scope header per request.

Responses

204

Successfully updated device common details

Language

Credentials

OAuth2

URL

Loading…

Response

Choose an example:

application/json

400Invalid request data (missing or invalid clientManagementId, etc.)

404No existing device common details found for the specified clientManagementId