List external datastore definitions

• Latest Dynatrace
• Reference
• Published Oct 13, 2026

List all external datastore definitions in Dynatrace Grail with the External Datastores API to review which external sources Grail can query.

Overview

You use this operation to retrieve every external datastore definition in your environment, for example to audit which external sources Grail can query or to export the definitions to another environment. It takes no parameters and returns the full list with a 200 response. To read a single definition, use its name with the get operation.

Authentication

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

Parameters

The request doesn't provide any configurable parameters.

Response

{
  "externalDatastores": [
    {
      "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",
    "code": 400
  }
}