Create an Amazon IVS real-time Stage, generate participant tokens, and join with WebRTC
domain: docs.aws.amazon.com · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Call CreateStage with an optional name and up to 12 participantTokenConfigurations entries to provision a stage and its initial tokens in one call; the response returns stage.arn and stage.endpoints (events, rtmp, rtmps, whip).
For participants beyond the initial batch, or when a token expires, call CreateParticipantToken with stageArn, userId, capabilities (array of PUBLISH/SUBSCRIBE), and duration in minutes.
Distribute each returned participantToken.token string to the matching client over your own authenticated backend channel (tokens are never retrievable again after creation).
On the client, use an IVS Broadcast SDK (Web, Android, or iOS) to join the stage with the token, publish local audio/video, and subscribe to other participants.
Tokens are scoped to the single stage they were created for and cannot be reused on another stage.
Known gotchas
CreateStage's participantTokenConfigurations array is capped at 12 items per call — larger stages require separate CreateParticipantToken calls for the rest.
capabilities defaults to both PUBLISH and SUBSCRIBE when omitted, so a viewer-only token requires explicitly passing capabilities: ["SUBSCRIBE"].
Token duration defaults to 720 minutes (12h) and maxes out at 20160 minutes (14 days); there is no API to look up or recover a token value after issuance.
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?