Get a shareable Magicast link
POST/magicast.shareLink
Returns a shareable player URL for a Magicast. Pass the id obtained from
/magicast.list or
/magicast.info.
This endpoint is get-or-create: it returns the Magicast's existing share link, or mints one the first time it is called. Repeat calls for the same Magicast return the same URL.
Creating a share link is a deliberate action, which is why it has its own
endpoint rather than being returned as a field that is always present on
magicast.list / magicast.info. Fetching a Magicast never mints a
shareable link as a side effect. magicast.info includes shareUrl only
when a link already exists.
The URL is https://ro.am/share/{key}. There is no
https://ro.am/magicast/{id} route.
You can only create a share link for a Magicast you can access; the same
access check as magicast.info applies.
Access: Organization and Personal. Personal access tokens restrict to Magicasts owned by the authenticated user.
Required scope: magicast:read
OpenAPI Spec: chat-v1.json
Request
Responses
- 200
- 400
- 401
- 404
- 405
- 500
The Magicast's shareable link.
Bad request. Missing or invalid id.
Presented invalid authentication credentials.
Magicast not found or not accessible.
An unsupported method was requested.
An internal error occurred.