List comments through a share link
Read every comment thread on a media file through a dashboard share link. Allowed while the dashboard's comments.isEnabled is true. resolvedBy and mediaLabelId are left out. No API key or access token: the share link token is the only credential. The media must be in one of the dashboard's folders. Every refusal returns the same 404 {"message": "Not found."}, so a link holder cannot tell which check failed. A media or folder embed token also works here while the embed's meta.isComments is true, for the embed's own media or media in its folders; an embed shows every active label and can never write. Reads are limited to 120 requests a minute per IP address.
Request
- Base URL: https://api.speakai.co/v1
- URL: https://api.speakai.co/v1/embed/media/{mediaId}/comments
- Auth: none required
Path parameters
Id of the media file. Trimmed, then 1 to 64 characters from A-Z, a-z, 0-9, _ and - (pattern ^[A-Za-z0-9_-]{1,64}$). Anything else returns 400.
Query parameters
The share link token of a dashboard, or of a media or folder embed on the read routes. Up to 200 characters.
Response
Success
Changes
No recorded changes to this operation across all 2 revisions of this API.