DeviceProvisioningRecipeUpdated

Emitted when an existing provisioning recipe is updated.

Payload

Field	Type	Required	Description
owner	object	✅	Ownership envelope identifying the company or organization that owns this event.
owner.ownershipType	"organization" (literal)	✅	Discriminator for the ownership envelope; always organization for these events.
owner.organizationUid	string	✅	UID of the organization that owns the event.
owner.parentCompanyUid	string	✅	UID of the owning organization's parent company.
organizationUid	string	—	Organization that owns this provisioning recipe.
status	"Pending" | "Applied" | "Failed" | "Invalid" (literal)	—	Current provisioning status of the recipe.
confirmedOwnership	boolean	—	Whether device ownership has been confirmed for this recipe.
serialNumber	string	—	Serial number of the device this recipe provisions.
macAddress	string	—	MAC address of the device this recipe provisions.
model	string	—	Model of the device this recipe provisions.
brand	string	—	Brand (manufacturer) of the device this recipe provisions.
tagUids	string[]	—	Tags to assign to the device once provisioned.
deviceName	string	—	Human-readable name to set on the device once provisioned.
policyUid	string	—	Policy to apply to the device once provisioned.
locationUid	string	—	Location to assign the device to once provisioned.
unsuccessfulRegisterAttemptStatus	object	—	Details of the most recent unsuccessful registration attempt, if any.
unsuccessfulRegisterAttemptStatus.warningMessage	string	✅	Human-readable reason the registration attempt did not succeed.
errorMessage	string	—	Error message describing why provisioning failed, if applicable.
type	"Device.ProvisioningRecipeUpdated" (literal)	✅	Fully-qualified event type discriminator (e.g. Device.DeviceConnectionAdded).
originator	object	—	Actor that initiated the action behind this event. Omitted for system-triggered events.
originator.accountId	number	—	Numeric identifier of the account that initiated the action.
originator.organizationUid	string	—	Organization on whose behalf the action was initiated.
originator.policyUid	string	—	Policy under which the action was initiated, if applicable.
uid	string	✅	Unique identifier of the entity.

Example

{
  "id": "string",
  "kind": "domain",
  "type": "Device.ProvisioningRecipeUpdated",
  "payload": {
    "owner": {
      "ownershipType": "organization",
      "organizationUid": "8429f601xxxxxxxxxxxxxxxxc54a5f56",
      "parentCompanyUid": "e990a597xxxxxxxxxxxxxxxxc6430ef4"
    },
    "organizationUid": "45051de2xxxxxxxxxxxxxxxx97ce5088",
    "status": "Pending",
    "confirmedOwnership": true,
    "serialNumber": "SN-306311",
    "macAddress": "81:FB:8D:9D:XX:XX",
    "model": "example-model",
    "brand": "example-model",
    "tagUids": [
      "85949411xxxxxxxxxxxxxxxx631f7794"
    ],
    "deviceName": "Example Name",
    "policyUid": "56c600e3xxxxxxxxxxxxxxxx8f802ee2",
    "locationUid": "ca73cb98xxxxxxxxxxxxxxxxde025557",
    "unsuccessfulRegisterAttemptStatus": {
      "warningMessage": "Something went wrong"
    },
    "errorMessage": "Something went wrong",
    "type": "Device.ProvisioningRecipeUpdated",
    "originator": {
      "accountId": 8538,
      "organizationUid": "4c824378xxxxxxxxxxxxxxxxd542c5b7",
      "policyUid": "3a9d047cxxxxxxxxxxxxxxxx91e30382"
    },
    "uid": "2dfae202xxxxxxxxxxxxxxxxcd8150f7"
  }
}

Shape

{
  "id": "string",
  "kind": "domain",
  "type": "Device.ProvisioningRecipeUpdated",
  "payload": {
    "owner": {
      "ownershipType": "organization",
      "organizationUid": "string",
      "parentCompanyUid": "string"
    },
    "organizationUid?": "string",
    "status?": "Pending | Applied | Failed | Invalid",
    "confirmedOwnership?": "boolean",
    "serialNumber?": "string",
    "macAddress?": "string",
    "model?": "string",
    "brand?": "string",
    "tagUids?": [
      "string"
    ],
    "deviceName?": "string",
    "policyUid?": "string",
    "locationUid?": "string",
    "unsuccessfulRegisterAttemptStatus?": {
      "warningMessage": "string"
    },
    "errorMessage?": "string",
    "type": "Device.ProvisioningRecipeUpdated",
    "originator?": {
      "accountId?": "number",
      "organizationUid?": "string",
      "policyUid?": "string"
    },
    "uid": "string"
  }
}