Skip to main content

Remove an AI model edition from all devices

DELETE 
/api/v1/orgs/{orgId}/ai-models/{modelId}/editions/{edition}/deployments

Removes the deployed model file from ALL devices that received this model edition.

• Batch operation: triggers delete commands for every device in the deployment.

• 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. Each target's 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. operationStatus aggregates the targets: IN_PROGRESS, PARTIAL_FAILED or FAILED.

• Each device deletes the file the next time it syncs. An offline device deletes it when it reconnects. No API confirms that a 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 deployment exists for the model/edition combination.

Request​

Responses​

202 Accepted with one dispatch result per device the delete command was requested for.