Shares

Get a share

Retrieves a specified share.

get/shares/{shareId}

Request

  • Base URL: http://example.com/authorization
  • URL: http://example.com/authorization/shares/{shareId}
  • Auth: none declared

Path parameters

shareIdstring required

The ID of the share to retrieve.

Response

The request succeeded.

sharedWithstring required

The principal name of the share recipient.

resourceUristring required

A relative URI that represents a resource. All shares must target a resource URI.

namestring

The user-friendly name of the shared resource.

sharedWithType'user' | 'group' | 'authenticatedUsers' | 'everyone' | 'guest' required

The type of principal to which the share applies.

type'read' | 'readEdit' | 'readShare' | 'readEditShare' required

The level of access that the share provides.

enabledboolean

Flag indicating whether the current share is in effect or not.

versioninteger

The version of the share representation. The current representation version is 2.

idstring

The unique identifier for the share.

createdBystring

The ID of the user who created the share.

creationTimeStampstring date-time

The date and time at which the share was created.

modifiedBystring

The ID of the last user to modify the share.

modifiedTimeStampstring date-time

The date and time at which the share was last modified.

Changes

No recorded changes to this operation across all 1 revision of this API.