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/api/v1/media/{id}/share
media:write
Query 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"
  }
}