Files
apple-device-management-mdm/mdm/errors/watch.pairing.token.missing.yaml
2025-09-15 20:38:03 -04:00

48 lines
1.7 KiB
YAML

title: Error Code Pairing Token Missing
description: An error response that indicates a missing pairing token.
payload:
supportedOS:
iOS:
introduced: n/a
macOS:
introduced: n/a
tvOS:
introduced: n/a
visionOS:
introduced: n/a
watchOS:
introduced: '10.0'
payloadkeys:
- key: code
type: <string>
presence: required
rangelist:
- com.apple.watch.pairing.token.missing
content: Indicates that the pairing token, which the system requires to enroll the
watch, is missing.
- key: description
type: <string>
presence: optional
content: A description of the error. Only use this for logging purposes and don't
display it to the user.
- key: message
type: <string>
presence: optional
content: A description of the error to display to the user.
- key: details
type: <dictionary>
presence: required
content: A dictionary that contains additional data about the error code.
subkeys:
- key: security-token
type: <string>
presence: required
content: The security token to pass to the phone's MDM server to create the pairing
token. This token needs to be a random UUID string.
notes:
- title: ''
content: |-
The schema for a JSON or property list XML document that an MDM server's 403 response body contains. The response headers need to include a "Content-Type" header that indicates whether the response returns JSON or XML.
The system returns this response when an Apple Watch enrolls in MDM, but the watch doesn't include a `PAIRING_TOKEN` in the `MachineInfo` request. After the watch receives this response, it fetches a pairing token from the phone's MDM server through a request to the phone. Then, the watch repeats the enrollment request and includes the pairing token.