Delete File

Remove a file from a specific volume. Intended for internal use - rather use the cerebrium rm command.

DELETE /v2/projects/{project_id}/volumes/{volume_id}/rm

Delete File

cURL

curl --request DELETE \
  --url https://rest.cerebrium.ai/v2/projects/{project_id}/volumes/{volume_id}/rm \
  --header 'Authorization: Bearer <token>'

400

{
  "message": "<string>"
}

Removes the file at path, rooted at the device’s shared storage, e.g. /Download/report.pdf. Deletion is immediate and permanent — there is no trash to recover from.

The endpoint targets individual files; to clear out a directory, list it and delete its files one by one.

Authorizations

Authorization · string · header · required

Service Account Token authentication. To authenticate API requests:

1. Create a Service Account Token:

   • Go to the Cerebrium Dashboard and open the API Keys page
   • Click Create Service Account, name it (e.g., "GitHub Actions CI/CD"), choose an expiry date, and click Create
   • Copy the token generated for the desired service account

2. Use the Token: Include the service account token in the Authorization header of API requests: Authorization: Bearer <your-service-account-token>

3. Best Practices:

   • Create separate service accounts for different environments (dev, staging, prod)
   • Store tokens securely as secrets in consuming applications or workflows
   • Set appropriate expiry dates and rotate tokens regularly
   • Never commit tokens to source control

For CI/CD integration examples, see the CI/CD documentation.

Path Parameters

project_id · string · required

volume_id · string · required

Query Parameters

file_path · string · required

Path of the file or directory to delete.

region · string

Region of the volume. Default: us-east-1.

Response

200

A plain text confirmation message that the file was deleted.