Try it free

Permanently delete a file

  • Latest Dynatrace
  • Reference
  • Published Oct 13, 2026

Delete a file from Dynatrace Grail Resource Store with the File API by providing its fully qualified file path in the request body.

POSTSaaShttps://{your-environment-id}.apps.dynatrace.com/v1/files:delete

Overview

Delete file

Delete a file from the Grail Resource Store.

ATTENTION - This operation is irreversible.

The request body needs to contain the request parameters (see below) in JSON format.

Request parameters

  • filePath (required) - The fully qualified file path of the file. Example: /lookups/mydata.

Authentication

To execute this request, you need a platform token or OAuth access token with storage:files:delete scope. To learn how to obtain and use it, see Tokens and authentication.

Parameters

ParameterTypeDescriptionInRequired
bodyResourceDeleteRequest

Request Details

bodyRequired

Request body objects

The ResourceDeleteRequest object

Request Details

ElementTypeDescriptionRequired
filePathstring

The fully qualified file path of the tabular file to store the lookup data in Grail.

Required

Request body JSON model

This is a model of the request body, showing the possible elements. It has to be adjusted for usage in an actual request.

{
"filePath": "/lookups/mydata"
}

Response

Response codes

CodeTypeDescription
204-

The requested file has been deleted successfully.

400ErrorEnvelope

Bad request for deleting the file.

401ErrorEnvelope

Unauthorized.

403ErrorEnvelope

Access forbidden.

404ErrorEnvelope

The file does not exist.

500ErrorEnvelope

Internal Server Error

4XXErrorEnvelope

Client Error

5XXErrorEnvelope

Server Error

Response body objects

The ErrorEnvelope object

ElementTypeDescription
errorExceptionalReturn-

The ExceptionalReturn object

ElementTypeDescription
codeinteger-
errorDetails(CustomValidationErrorInfo | InvalidAuditEventsErrorInfo | MediaTypeErrorInfo | ParameterErrorInfo | ProxyErrorInfo | QueryFrontendRawErrorInfo | RequestBodyErrorInfo)[]-
messagestring-

The CustomValidationErrorInfo object

The ErrorInfo object

ElementTypeDescription
messagestring-

The InvalidAuditEventsErrorInfo object

The MediaTypeErrorInfo object

The ParameterErrorInfo object

The ProxyErrorInfo object

The QueryFrontendRawErrorInfo object

The RequestBodyErrorInfo object

Response body JSON models

{
"error": {
"code": 400,
"message": "File path must not be blank."
}
}
Related tags
Platform APIDynatrace Platform