Add recipients to a direct share

• Latest Dynatrace
• Reference
• Published Oct 13, 2026

Add recipients to a direct share in Dynatrace with the Document API so selected SSO users and groups gain access immediately.

Overview

Add one or multiple SSO-users and/or SSO-groups to this share. The affected users immediately gain access to the document.

You can only add recipients to shares which are 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. The maximum number of recipients is 1000.

The validity of the SSO-users and SSO-groups isn't verified. It's technically possible, albeit pointless, to add non-existing users and groups.

Already added users or groups are ignored.

Authentication

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

Parameters

{
  "recipients": [
    {
      "id": "441664f0-23c9-40ef-b344-18c02c23d789",
      "type": "group"
    }
  ]
}

Response