List direct shares

• Latest Dynatrace
• Reference
• Published Oct 13, 2026

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

Overview

List all direct-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 shares, or a specific share, you can use the filter parameter to narrow down the result set. If you attempt to retrieve shares which are not accessible to you the result set will be empty.

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:direct-shares:read scope. To learn how to obtain and use it, see Tokens and authentication.

Parameters

Response

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