GET/groups/{groupId}/folder/link-setting

Gets link settings required to create a link for 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/link-setting

Path Parameters

ParameterTypeDescription
groupId string 

Team/group ID


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

Header Parameters

HeadertypeDescription
Authorization string 

Bearer {token}


required 

Response

HTTP 200

OK

PropertyTypeDescription
enabledOrganizationAccessType boolean 

Indicates whether a link with the accessType ORGANIZATION can be created.

 
enabledSpecificPeopleAccessType boolean 

Indicates whether a link with the accessType SPECIFIC_PEOPLE can be created.

 
enabledAnyoneAccessType boolean 

Indicates whether a link with the accessType ANYONE can be created.

 
maxLinkRetentionDays integer 

Maximum retention period in days. When creating or updating a link, the expirationTime value must be less than the maxLinkRetentionDays value.

  • -1: No expiration date
  • 7: 7 days
  • 30: 30 days
  • 90: 90 days
  • 180: 180 days

Allowed values : -1, 7, 30, 90, 180 

Response Example

example

1{2  "enabledOrganizationAccessType": true,3  "enabledSpecificPeopleAccessType": true,4  "enabledAnyoneAccessType": false,5  "maxLinkRetentionDays": 306}