Delete an external datastore definition

• Latest Dynatrace
• Reference
• Published Oct 13, 2026

Delete an external datastore definition from Dynatrace Grail by its name with the External Datastores API when Grail no longer needs to query it.

Overview

You use the storeName path parameter to delete an external datastore definition that Grail no longer needs to query. The definition is removed from your environment, and a 200 response confirms the deletion. To review the remaining definitions afterward, list all external datastore definitions.

Authentication

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

Parameters

Response

{
  "type": "s3://",
  "name": "my-s3-store",
  "displayName": "My S3 Store",
  "bucketName": "my-s3-bucket",
  "region": "us-east-2",
  "connectionId": "my-connection-id",
  "connectionName": "my-connection-name",
  "version": 1
}

{
  "error": {
    "message": "Constraint Violations",
    "details": {
      "constraintViolations": [
        {
          "message": "must not be blank",
          "parameterDescriptor": "storeName"
        }
      ]
    },
    "code": 400
  }
}