Capability Sources

Find the OneDrive, SharePoint or Teams file behind a link

Changed on

Turns a OneDrive, SharePoint or Teams file link the member can open into the item's driveId and id, for reading, pulling or saving it. Read-only; files outside the member's own OneDrive need the all-files permission.

get/v1/capabilities/microsoft-365/drive-item-by-link

Request

  • Base URL: https://api.openworklabs.com
  • URL: https://api.openworklabs.com/v1/capabilities/microsoft-365/drive-item-by-link
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Query parameters

urlstring starts_with required

The file's OneDrive, SharePoint or Teams link.

Response

The linked item.

oktrue required

Changes

    • breaking

      for the query request parameter url, the format changed from uri to starts_with

    • breaking

      the response property / became nullable for the status

    • breaking

      the response property / became nullable for the status

    • breaking

      the response property / became nullable for the status

    • info

      response property anyOf[InvalidRequestError]/details/items/path/items/ list-of-types was narrowed by removing types number from media type application/json of response 400

    • info

      response property anyOf[subschema #2]/currentRevision list-of-types was narrowed by removing types null from media type application/json of response 409

    • info

      response property anyOf[subschema #2]/modifiedTime list-of-types was narrowed by removing types null from media type application/json of response 409

    • info

      response property file/size list-of-types was narrowed by removing types null from media type application/json of response 200

    • info

      endpoint added