v1Resources/Media/postShare an asset
Share an asset
Issues (or rotates) a public link for the asset. Rotating revokes any link issued before it.
post
media:write/api/v1/media/{id}/shareQuery parameters
idstringrequired
The asset to share.
Response
dataobjectoptional
urlstringoptional
The public share URL.
accessstring (link)optional
Always "link" on success.
Errors
400The request is missing a required parameter or is otherwise malformed.
401Missing, invalid, expired, or revoked API key.
403The key lacks the required scope, or isn't authorized for this client/location.
429Too many requests. Retry after the number of seconds in the Retry-After header.
post/api/v1/media/{id}/share
Your API key
id *
{
"data": {
"url": "https://synup.com/s/kL9mN2pQr",
"access": "link"
}
}