Partially update an external datastore definition

• Latest Dynatrace
• Reference
• Published Oct 13, 2026

Partially update an external datastore definition in Dynatrace Grail with the External Datastores API, changing only the fields you send in the request.

Overview

Partially update an existing external datastore definition.

Only the provided fields will be updated. The name field cannot be changed after creation.

The following fields can be updated:

Uses optimistic locking - pass the current version via the optimistic-locking-version query parameter.

Authentication

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

Parameters

{
  "type": "s3://",
  "displayName": "My Updated S3 Store",
  "bucketName": "my-updated-s3-bucket"
}

Response

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

{
  "error": {
    "message": "Constraint Violations",
    "details": {
      "constraintViolations": [
        {
          "message": "size must be between 0 and 200",
          "parameterDescriptor": "displayName"
        }
      ]
    },
    "code": 400
  }
}