Skip to content

Manage assets ​

Edit your asset's name, description or group, or disable a record you no longer use.

Edit or move an asset ​

bash
curl -X PATCH https://moonnexai.com/v1/assets/asset_xxx \
  -H "Authorization: Bearer <MOONNEXAI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "product-reference",
  "description": "Updated reference",
  "group_id": "group_target"
}'

Send at least one of name, description or group_id. Omitted fields keep their value; an empty description clears it, while name cannot be empty. The target group must be enabled and owned by your account.

Success returns HTTP 200 with the updated flat asset object. Moving keeps the asset ID, content and existing preparation; it does not replace the file or create new model preparation.

Disable an asset ​

bash
curl -X DELETE https://moonnexai.com/v1/assets/asset_xxx \
  -H "Authorization: Bearer <MOONNEXAI_API_KEY>"

This is a local soft deletion. HTTP 200, deleted=true and status=disabled confirm success. A missing, foreign or already disabled asset returns 404 / asset_not_found.

Disabling retains history and audit records. It does not immediately erase hosted files, invalidate issued URLs, cancel generation tasks or delete media held by another service. Removing a group is a separate operation and does not disable its member assets; see groups.

Errors ​

HTTPCodeMeaning
400invalid_asset_id, invalid_name, invalid_group_id, missing_update_fieldsInvalid ID, name or edit fields.
404asset_not_foundMissing, foreign or disabled asset.
404group_not_foundTarget group is missing, foreign or unavailable.