RESTful API for live streaming infrastructure
Connect to WAVE's production API
Base URL
https://api.wave.inc/v1Authorization header with a valid API key. Rate limits apply based on your plan tier.3 endpoints
/v1/auth/keysGenerate API keys
admin/v1/auth/keysList API keys
admin:read/v1/auth/keys/{key_id}Revoke API key
admin5 endpoints
/v1/streamsCreate new stream
streams:write/v1/streamsList streams
streams:read/v1/streams/{stream_id}Get stream details
streams:read/v1/streams/{stream_id}Update stream
streams:write/v1/streams/{stream_id}Delete stream
streams:write3 endpoints
/v1/recordingsList recordings
recordings:read/v1/recordings/{recording_id}Get recording details
recordings:read/v1/recordings/{recording_id}Delete recording
recordings:write2 endpoints
/v1/analytics/streams/{stream_id}Get stream analytics
analytics:read/v1/analytics/viewers/{stream_id}Get viewer metrics
analytics:read3 endpoints
/v1/webhooksCreate webhook
webhooks:write/v1/webhooksList webhooks
webhooks:read/v1/webhooks/{webhook_id}Delete webhook
webhooks:writeComplete request and response example
POST /v1/streams
Host: api.wave.inc
Authorization: Bearer wave_live_xxxxx
Content-Type: application/json
{
"title": "Product Launch Event",
"protocol": "webrtc",
"recording": {
"enabled": true,
"format": "mp4",
"storage": "cloud"
},
"transcoding": {
"enabled": true,
"profiles": ["720p", "1080p"]
},
"metadata": {
"category": "business",
"tags": ["product", "launch", "2025"]
}
}