Skip to main content

Delete a share's files

POST 
/shares/:name/data/delete

Required role: admin. Only an account or token with the admin role can call this operation.

Example request
curl --request POST \
  --header "Authorization: Bearer $HOSERVA_TOKEN" \
  --header "Content-Type: application/json" \
  --data @body.json \
  "https://$HOSERVA_HOST:8008/api/v1/shares/{name}/data/delete"

Deletes this share's files on the branches that hold it, and nothing else — not other shares, not the parity file, not disks that do not hold this share. The definition is left in place. confirmation must equal the share name. Refused with 409 migration_in_progress while an Unraid import is pending its point of no return: the adopted disks are not written until then.

Request​

Responses​

Share data deleted.