Skip to main content

Remove an AI model edition from a device

DELETE 
/api/v1/devices/{deviceId}/ai-models/{modelId}/editions/{edition}

Removes the deployed model file from a specific device.

• Removes the file from the device's desired configuration. The device deletes the file the next time it syncs. An offline device deletes it when it reconnects.

• The response reports dispatch only: the deployment is removed from the cloud as soon as the request is handled, and GET /api/v1/devices/{deviceId}/ai-models stops listing it. Its state is FILE_DELETE_PENDING when the file was removed from the device's desired configuration, or FAILED_RECEIVE (with a reason) when that update failed. No API confirms that the device has deleted the file.

• FAILED_RECEIVE means the desired configuration could not be updated. It does not mean the device is offline. The file may stay on the device. To remove it, deploy the same edition to the device again, then delete it again.

• Returns 404 if no active deployment exists for the device/model/edition combination.

Request​

Responses​

202 Accepted with the dispatch result of the delete command for the device.