POST
/api/v1/workspaces/{workspace_id}/folders/{folder_id}/access/shareShare a folder with people or teams
Gives people (by email) and teams access to everything in the folder that isn't private, now and later. Each person newly given access gets one email and one notification for the whole folder, never one per item.
API token required30 per minute per IP
Guide: Folder access
Code samples and Try itPath parameters
#workspace_idstringRequiredThe workspace's id, from the address of its settings page (
markdrop.in/settings/workspaces/<workspace-id>) or from List workspaces.folder_idstringRequiredThe folder's id, from List folders.
Request body
#application/json, required
emailsarray of stringUp to 50 items.
team_idsarray of stringTeam ids, slugs or names. Up to 20 items.
role"viewer" | "editor"Default
"viewer".notifybooleanDefault
true.messagestringUp to 500 characters.
restrictbooleanAlso restrict the folder to its people and teams (true), or lift the restriction (false). Absent: unchanged.
Responses
#200OK.401No token, or the token is revoked or mistyped.422The request didn't validate.detaillists each problem, with where it is (loc) and why (msg).429Too many requests from your IP address. Wait the seconds inRetry-After.