SMsmartsheet
sharing

Get asset share

Retrieves a specific share for the specified asset.

get/shares/{shareId}

Request

  • Base URL
    https://api.smartsheet.com/2.0
  • Auth
    • HTTP bearer
    • or OAuth 2
      Authorization code: https://app.smartsheet.com/b/authorize
      Token URL: https://api.smartsheet.com/2.0/token scopes: ADMIN_WORKSPACES, SHARE_SHEETS, SHARE_SIGHTS

Path parameters

shareIdstring required

The unique identifier for the share.

Query parameters

assetType'sheet' | 'report' | 'sight' | 'workspace' | 'collection' | 'file' required
Example:sheet

The type of the asset. Used in combination with assetId to determine the asset.

assetIdstring required
Example:1234567890

The ID of the asset being accessed. It's used in combination with assetType to determine the asset.

Depending on the asset, this may be a numeric or string value.

Response

The share specified by the shareId.

idstring required

The ID of the share.

emailstring

User's primary email address for user shares.

userIdnumber

User ID if the share is a user share.

groupIdnumber

Group ID if the share is a group share.

namestring

If present, the name of the user or group to which the asset is shared.

typestring required

The type of this share. One of the following values: GROUP or USER.

accessLevel'ADMIN' | 'COMMENTER' | 'EDITOR' | 'EDITOR_SHARE' | 'OWNER' | 'VIEWER' required
scope'ITEM' | 'WORKSPACE' required

The scope of this share. One of the following values:

  • ITEM: an item-level share (that is, the specific object to which the share applies is shared with the user or group).
  • WORKSPACE: a workspace-level share (that is, the workspace that contains the asset to which the share applies is shared with the user or group).

Example response

{
  "id": "AAAMCmYGFOeE",
  "email": "test.email@smartsheet.com",
  "userId": 9876543210,
  "groupId": 1234567890,
  "name": "Example Name",
  "type": "USER"
}

Changes

No recorded changes to this operation across all 16 revisions of this API.