Get Public Link
get
/documents/api/1.1/publiclinks/{linkId}
Return information about a specific public link.
Request
Supported Media Types
- application/json
- application/xml
Path Parameters
- linkId
-
Type:
string
Required:true
Globally unique identifier (GUID) for the public link.
Response
Supported Media Types
- application/json
- application/xml
200 Response
The request was fulfilled.
Body
The response body includes information about the public link.
Root Schema : PublicLinkGetResponse
Type:
object
The response body includes information about the public link.
- errorCode
-
Type:
string
An error code of zero (0) indicates no errors.
-
Type:
object
PublicLinkDefinitionAdditional Properties Allowed:Public link information.
Nested Schema : PublicLinkDefinition
Public link information.
- assignedUsers
-
Type:
string
The group of users who can use the link. - createdTime
-
Type:
string
Date and time when the public link was created. - expirationTime
-
Type:
string
Date and time when the public link expires. - lastModifiedTime
-
Type:
string
Date and time when the public link was last modified. - linkID
-
Type:
string
Globally unique identifier (GUID) for the public link. - linkName
-
Type:
string
Name of the public link. - ownedBy
-
Type:
object
UserAdditional Properties Allowed:User information - password
-
Type:
string
Password for the public link. Use a minimum of 8 characters and a maximum of 50 characters. Passwords are case-sensitive. - role
-
Type:
string
Allowed Values:[ "viewer", "downloader", "contributor" ]
Access level for the shared item. - type
-
Type:
string
Item typepubliclink
.
Nested Schema : User
User information
- displayName
-
Type:
string
The display name for the user. - id
-
Type:
string
Globally unique identifier (GUID) for the user. - type
-
Type:
string
Item typeuser
.
Example application/json
{
"linkID":"LF906748A021ACD714CABC82T0000000000100000001",
"linkName":"MyLinkOne",
"assignedUsers":"@everybody",
"role":"contributor",
"type":"publiclink",
"createdTime":"2015-06-10T16:01:44Z",
"expirationTime":"2016-01-01T00:00:01Z",
"lastModifiedTime":"2015-06-10T16:01:44Z",
"ownedBy":{
"id":"U0EAA20910FAF3052ACB79E4T00000000001",
"displayName":"User AA",
"type":"user"
},
"errorCode":"0"
}
400 Response
Request parameters are not formatted correctly.
403 Response
Forbidden if the user does not have read permission.
404 Response
Link ID is not found.
Examples
The following example returns information about the specified public link.
GET .../publiclinks/LF906748A021ACD714CABC82T0000000000100000001
Request Header
None.
Request Body
None.
HTTP Status Code
HTTP_STATUS = 200
JSON Response
{ "assignedUsers": "@everybody", "createdTime": "2015-06-10T16:01:44Z", "errorCode": "0", "expirationTime": "2016-01-01T00:00:01Z", "lastModifiedTime": "2015-06-10T16:01:44Z", "linkID": "LF906748A021ACD714CABC82T0000000000100000001", "linkName": "MyLinkOne", "ownedBy": { "displayName": "User AA", "id": "U0EAA20910FAF3052ACB79E4T00000000001", "type": "user" }, "role": "contributor", "type": "publiclink" }