Skip to main content

Create Deployment

POST 
/api/v1/orgs/{orgId}/ai-models/{modelId}/editions/{edition}:deploy

Deploys a specific model edition to one or more edge devices.

• Each target group can specify ACL rules and pre/post lifecycle commands.

• PreCmd.action meanings: NOOP (skip), BACKUP_CURRENT (backup current file), STOP_CONTAINER (stop runtime first), CHECK_DISK_USAGE (validate capacity), CLEAN_STAGING (clean temp/staging files).

• ValidateCmd.action meanings: NOOP (skip), CHECKSUM_VERIFY (hash check), FILE_SIZE_VERIFY (size check), SIGNATURE_VERIFY (signature check).

• ApplyCmd.action meanings: NOOP (skip), ATOMIC_SWAP (replace atomically), ATOMIC_SWAP_AND_RESTART_CONTAINER (replace then restart runtime), RENAME_AND_RELOAD_SERVICE (rename into place and reload service).

• PostCmd.action meanings: NOOP (skip), HEALTH_CHECK_HTTP (HTTP endpoint check), HEALTH_CHECK_TCP (TCP reachability), HEALTH_CHECK_PROCESS (process running), HEALTH_CHECK_FILE_EXISTS (file path exists).

• The model file is delivered via Secured Volume and NATS file delivery.

• Returns 202 with per-device deployment IDs and initial state "SENT".

• Returns 409 if the same fileId is already deployed to any target device.

Request​

Responses​

Accepted