Get Shared Link Metadata

POST

https://api.dropboxapi.com/2/sharing/get_shared_link_metadata

POST

/2/sharing/get_shared_link_metadata

import requests
url = "https://api.dropboxapi.com/2/sharing/get_shared_link_metadata"
payload = {
    "url": "https://www.dropbox.com/s/2sn712vy1ovegw8/Prime_Numbers.txt?dl=0",
    "path": None
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  ".tag": "file",
  "client_modified": "2015-05-12T15:50:38Z",
  "id": "id:a4ayc_80_OEAAAAAAAAAXw",
  "link_permissions": {
    "allow_comments": true,
    "allow_download": true,
    "audience_options": [
      {
        "allowed": true,
        "audience": {
          ".tag": "public"
        }
      },
      {
        "allowed": false,
        "audience": {
          ".tag": "team"
        }
      },
      {
        "allowed": true,
        "audience": {
          ".tag": "no_one"
        }
      }
    ],
    "can_allow_download": true,
    "can_disallow_download": false,
    "can_remove_expiry": false,
    "can_remove_password": true,
    "can_revoke": false,
    "can_set_expiry": false,
    "can_set_password": true,
    "can_use_extended_sharing_controls": false,
    "require_password": false,
    "resolved_visibility": {
      ".tag": "public"
    },
    "revoke_failure_reason": {
      ".tag": "owner_only"
    },
    "team_restricts_comments": true,
    "visibility_policies": [
      {
        "allowed": true,
        "policy": {
          ".tag": "public"
        },
        "resolved_policy": {
          ".tag": "public"
        }
      },
      {
        "allowed": true,
        "policy": {
          ".tag": "password"
        },
        "resolved_policy": {
          ".tag": "password"
        }
      }
    ]
  },
  "name": "Prime_Numbers.txt",
  "path_lower": "/homework/math/prime_numbers.txt",
  "rev": "a1c10ce0dd78",
  "server_modified": "2015-05-12T15:50:38Z",
  "size": 7212,
  "team_member_info": {
    "display_name": "Roger Rabbit",
    "member_id": "dbmid:abcd1234",
    "team_info": null
  },
  "url": "https://www.dropbox.com/s/2sn712vy1ovegw8/Prime_Numbers.txt?dl=0"
}

Get the shared link’s metadata.

Required scope: sharing.read

Endpoint format: RPC

Authentication: App, User

Get the shared link's metadata. **Required scope:** `sharing.read` **Endpoint format:** [RPC](https://docs.dropboxapi.com/dropbox-api/docs/technical-reference/request-response-formats#rpc-endpoints) **Authentication:** [App](https://docs.dropboxapi.com/dropbox-api/docs/auth-types#app-authentication), [User](https://docs.dropboxapi.com/dropbox-api/docs/auth-types#user-authentication)

Authentication

AuthorizationBearer

App-level OAuth 2.0 token (no user context). Use Authorization: Bearer <token>.

Obtain by calling the token endpoint with grant_type=client_credentials.

Only available on endpoints that declare app auth support.

AuthorizationBearer

OAuth 2.0 token issued to a specific user. Use Authorization: Bearer <token>.

Public clients should use the authorization code flow with PKCE (S256).

For background or offline access, send token_access_type=offline during authorization and use the returned refresh token to obtain new access tokens.

You can generate a short-lived access token from the App Console; see Testing with a generated token.

OAuth 2.0 token issued to a specific user. Use `Authorization: Bearer <token>`. Public clients should use the authorization code flow with PKCE (S256). For background or offline access, send `token_access_type=offline` during authorization and use the returned refresh token to obtain new access tokens. You can generate a short-lived access token from the App Console; see [Testing with a generated token](https://docs.dropboxapi.com/dropbox-api/docs/oauth#testing-with-a-generated-token).

Headers

Dropbox-API-Path-RootstringOptional

Scopes path-based operations to a namespace (root). The value is a JSON serialization of the common.PathRoot union: {".tag": "home"}, {".tag": "root", "root": "<namespace_id>"}, or {".tag": "namespace_id", "namespace_id": "<namespace_id>"}. On failure the request returns 422 with a common.PathRootError.

Scopes path-based operations to a namespace (root). The value is a JSON serialization of the `common.PathRoot` union: `{".tag": "home"}`, `{".tag": "root", "root": "<namespace_id>"}`, or `{".tag": "namespace_id", "namespace_id": "<namespace_id>"}`. On failure the request returns 422 with a `common.PathRootError`.

Request

This endpoint expects an object.

urlstringRequired

URL of the shared link.

link_passwordstring or nullOptional

If the shared link has a password, this parameter can be used.

pathany or nullOptional

If the shared link is to a folder, this parameter can be used to retrieve the metadata for a specific file or sub-folder in this folder. A relative path should be used.

Response headers

X-Dropbox-Request-IdstringOptional

A unique identifier for the request, useful for debugging and support.

Response

Successful response

Variant:

sharing_apiv2.SharedLinkMetadata.fileobject

Errors

401

Unauthorized Error

403

Forbidden Error

409

Conflict Error

429

Too Many Requests Error

500

Internal Server Error