About this resource
A paged collection of SharedDownloadLinkListItem items. The collection contains the shared download links created by the current user, or by all users of the tenant when requested by an administrator.
Properties
| Property | Description | Type |
|---|---|---|
| items | One page of this paged collection, which is a subcollection of the complete collection. | Collection of SharedDownloadLinkListItem items |
| page | The current page of this paged collection. | int32 |
| pageSize | The current page size of this paged collection. | int32 |
| skip | The current skip size of this paged collection. | int32 |
| take | The current take size of this paged collection. | int32 |
| totalCount | The total count of items in this paged collection, not just on the current page. | int64 |
Relations
Examples
Listing shared download links
By default the collection only contains the shared download links created by the current user.
The parameters are specified as http headers.
GET /shareddownloadlinks HTTP/1.1 accept: application/hal+json filter: expiresOn >= '2026-08-01' sort: createdon desc page: 1 pageSize: 25
Members of the Administrators user group can list the links of all users of the tenant by adding
the allUsers query string parameter. For any other user this returns 403 Forbidden.
GET /shareddownloadlinks?allUsers=true HTTP/1.1 accept: application/hal+json
The collection can be filtered by link id, expiration date, revocation state, creator and file name, for example:
GET /shareddownloadlinks?filter=File.FileName+%3D+'*brochure*' HTTP/1.1 accept: application/hal+json
The boolean revoked field matches links that have (or have not) been revoked; combine it with
an expiration date predicate to select only active links:
GET /shareddownloadlinks?filter=expiresOn+%3E%3D+'2026-08-01'+and+revoked+%3D+false HTTP/1.1 accept: application/hal+json