v1Resources/Data/postShare a folder
Share a folder
Issues (or rotates) a public link for the folder. Rotating revokes any link issued before it. Requires an active, identified agency user with Media access; both user and credential client restrictions apply.
post
media:write/api/v1/folders/{id}/shareQuery parameters
idstringrequired
The folder to share.
Response
dataobjectoptional
urlstringoptional
The public share URL.
accessstring (link)optional
Always "link" on success.
Errors
401Missing, invalid, expired, or revoked API key.
403The key lacks the required scope, or isn't authorized for this client/location.
404The resource wasn't found, or doesn't belong to your agency.
429Too many requests. Retry after the number of seconds in the Retry-After header.
post/api/v1/folders/{id}/share
Your API key
id *
{
"data": {
"url": "https://synup.com/s/aB3dE9fGhJ",
"access": "link"
}
}