GET/groups/{groupId}/folder/files/{fileId}/link

Gets the link properties of a file in a team/group folder.

Authorization

oauth2

OAuth 2.0 authentication.
For more information, see Authentication and Authorization.

Scope

file
file.read
group.folder
group.folder.read

HTTP Request

GEThttps://www.worksapis.com/v1.0/groups/{groupId}/folder/files/{fileId}/link

Path Parameters

ParameterTypeDescription
groupId string 

Team/group ID


required
example : group127-8545-4463-603b-04d550d23bf 
fileId string 

File ID


required
example : NzExNTMwMDF8MTQ2NzA1NjAxMDAwMHxGfDA 

Header Parameters

HeadertypeDescription
Authorization string 

Bearer {token}


required 

Response

HTTP 200

OK

PropertyTypeDescription
accessType string 

Link access type

  • ORGANIZATION: Accessible only to members
  • SPECIFIC_PEOPLE: Accessible only to specified users (authenticated with OTP)
  • ANYONE: Accessible to anyone

Allowed values : ORGANIZATION, SPECIFIC_PEOPLE, ANYONE 
hasPassword boolean 

Indicates whether the link has a password.

 
linkPermissionType string 

Link permission type (Sharees who access the link can perform only the tasks permitted by the specified permission type.)

  • EDIT: Edit (move, delete, restore, etc.), upload/copy (overwritable), download, preview
  • UPLOAD_DOWNLOAD: Upload/copy (not overwritable), download, preview
  • UPLOAD: Upload/copy (not overwritable), preview
  • DOWNLOAD: Download, preview
  • PREVIEW: Preview

Allowed values : EDIT, UPLOAD_DOWNLOAD, UPLOAD, DOWNLOAD, PREVIEW 
linkUrl string 

Access URL


readOnly : true 
createdTime string 

Link creation time


readOnly : true 
expirationTime string 

Link expiration time (null if there is no expiration date)


nullable : true 
specificPeople array (string) 

List of members if the accessType is SPECIFIC_PEOPLE.


nullable : true 

Response Example

example

1{2  "accessType": "SPECIFIC_PEOPLE",3  "hasPassword": false,4  "linkUrl": "https://works.do/xzO8Bv",5  "createdTime": "2024-10-10T09:18:24+09:00",6  "expirationTime": "2024-10-17T09:18:24+09:00",7  "linkPermissionType": "EDIT",8  "specificPeople": [9    "abc@example.com"10  ]11}