List environment shares

• Latest Dynatrace
• Reference
• Published Oct 13, 2026

List environment shares accessible to you in Dynatrace with the Document API, with optional filtering and pagination for document access.

Overview

List all environment-shares accessible to you. Shares accessible to you include those of your own documents, as well as those of reshareable documents owned by other users to which you have write access. If you are only concerned with a specific document's environment-shares, or a specific share, you can use the filter parameter to narrow down the result set. If you attempt to retrieve environment-shares of a document not accessible by you, the result set will be empty.

Furthermore, you can apply pagination via the pageKey, page and pageSize parameters.

Note, that at the moment we offer a naive pagination, and therefore interim mutations can lead to result inconsistencies (such as duplicates, missing entries).

Authentication

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

Parameters

Response

{
  "environment-shares": [
    {
      "id": "af21cc73-bb1c-45f1-ad1b-12e8f91b9fbc",
      "documentId": "1d1cf013-fd4c-463e-a8ad-912485daf711",
      "access": [
        "read"
      ],
      "claimCount": 5
    },
    {
      "id": "f0ed12ec-f232-45db-b667-26b2cf414787",
      "documentId": "1d1cf013-fd4c-463e-a8ad-912485daf711",
      "access": [
        "read",
        "write"
      ],
      "claimCount": 0
    },
    {
      "id": "9dc638d0-0cea-4c9c-ad9c-85ec02d967d6",
      "documentId": "4f135fa6-0c1b-456d-b962-20f14a2ac67e",
      "access": [
        "read",
        "write"
      ],
      "claimCount": 42
    }
  ],
  "nextPageKey": "bmQgUXVhcms=",
  "totalCount": 42
}