drives.driveItem

Invoke action createLink

Create a link to share a driveItem driveItem. The createLink action creates a new sharing link if the specified link type doesn't already exist for the calling application. If a sharing link of the specified type already exists for the app, the existing sharing link is returned. DriveItem resources inherit sharing permissions from their ancestors.

post/drives/{driveId}/items/{driveItemId}/microsoft.graph.createLink

Request

Base URL
https://graph.microsoft.com/v1.0
Auth
OAuth 2
Authorization codehttps://login.microsoftonline.com/common/oauth2/v2.0/authorize
Token URLhttps://login.microsoftonline.com/common/oauth2/v2.0/token
TypeScript
https://skmtc.dev/ballerina-platform/apis/files/docs/drives/:driveId/items/:driveItemId/microsoft.graph.createLink/post.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

driveIdstring required

The unique identifier of drive

driveItemIdstring required

The unique identifier of driveItem

Request body

typestring nullable

scopestring nullable

expirationDateTimestring date-time nullable

passwordstring nullable

messagestring nullable

retainInheritedPermissionsboolean nullable

sendNotificationboolean nullable

Response

Success

idstring

The unique identifier for an entity. Read-only.

expirationDateTimestring date-time nullable

A format of yyyy-MM-ddTHH:mm:ssZ of DateTimeOffset indicates the expiration time of the permission. DateTime.MinValue indicates there's no expiration set for this permission. Optional.

hasPasswordboolean nullable

Indicates whether the password is set for this permission. This property only appears in the response. Optional. Read-only. For OneDrive Personal only..

rolesstring[]

The type of permission, for example, read. See below for the full list of roles. Read-only.

shareIdstring nullable

A unique token that can be used to access this shared item via the shares API. Read-only.

Changes

No operation changes recorded.