A share gives a project a public id; GET /shares/{share_id} answers anyone holding it, with no API key.It plays one finished generation (the newest, or one you pin) and never the uploaded original. Revoke it to turn it off.
How it works
not shared: a new project
published: PUT …/share; the id stays the same when you publish again
revoked: DELETE …/share; the id answers 404 share_not_found
from published: new version, a changed generation_id or preview_seconds: earlier URLs stop
A project's share. Deleting the project revokes it too.
Limits
Limit
Value
Share id
17 characters
preview_seconds
4 to 3600, rounded up to whole 4 second segments
Old URLs after a revoke or change
stop within about a minute
API key
not needed for GET /shares/{share_id}; any origin may call it
Files
the shared generation's playback files; never original