REST API Reference

List all rooms in your account.

curl -X GET https://api.gravixcloud.com/v1/rooms \
  -H "Authorization: Bearer gvx_live_your_key"

# Response
{
  "rooms": [
    {
      "id": "room_abc123",
      "name": "standup-call",
      "maxParticipants": 50,
      "recording": true,
      "createdAt": "2025-01-15T10:00:00Z"
    }
  ],
  "total": 1
}

Create a new room.

curl -X POST https://api.gravixcloud.com/v1/rooms \
  -H "Authorization: Bearer gvx_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "team-standup",
    "maxParticipants": 50,
    "recording": true,
    "persistent": true
  }'

# Response
{
  "id": "room_xyz789",
  "name": "team-standup",
  "url": "https://app.gravixcloud.com/r/xyz789",
  "maxParticipants": 50,
  "recording": true
}

Delete a room and disconnect all participants.

curl -X DELETE https://api.gravixcloud.com/v1/rooms/room_xyz789 \
  -H "Authorization: Bearer gvx_live_your_key"

# Response: 204 No Content