Delete file

curl --request DELETE \
  --url https://app.azalt.co/api/v1/media/{mediaId} \
  --header 'Authorization: Bearer <token>'

{
  "id": "<string>"
}

File

Delete file

Permanently delete a file from both the database and cloud storage. This action cannot be undone.

Required parameter:

mediaId: The unique ID of the file to delete

What happens when you delete:

File record is removed from the database
Actual file is deleted from cloud storage
All associated metadata is cleaned up
Deletion is logged for audit purposes

Security checks:

You must have proper permissions for the file’s related item
Only users in the same organization can delete files
Critical files may be soft-deleted to preserve audit trails

⚠️ Before deleting, consider:

Are any forms, dashboards, or reports using this file?
Is this file required for compliance or regulatory purposes?
Will deleting this affect other parts of the system?

Good reasons to delete:

Remove outdated or incorrect documents
Clean up test files or duplicates
Comply with data retention policies
Fulfill user requests for file removal

DELETE

media

{mediaId}

Delete file

curl --request DELETE \
  --url https://app.azalt.co/api/v1/media/{mediaId} \
  --header 'Authorization: Bearer <token>'

{
  "id": "<string>"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

mediaId

string

required

Response

object | null

Successful response

string

required

Get files by entity Get public form

⌘I

Activity

ActivityDefinition

ApiKey

Dashboard

Widget

DatasetItem

Dataset

File

Form

FormElement

FormElementSubmission

FormSubmission

FormSite

Indicator

Organization

Site

Target

Benchmark

Unit

User

Delete file

Authorizations

Path Parameters

Response