Velora local API

​

Availability

• Recommended Velora Version: 6.5.0
• Minimum Velora Version: 6.3.0
• Host: 127.0.0.1
• Default port: 39031
• Base URL: http://127.0.0.1:39031
• Transport: HTTP and WebSocket
• CORS: * with Authorization and Content-Type
• Scope: local machine only (loopback addresses)

​

What you can do

• Check server status
• Read the current track
• Read playback state
• Read playback queue
• Read the signed-in user’s public profile snapshot
• Subscribe to playback updates over WebSocket

• Play a specific track (or resume)
• Pause playback
• Skip to next track
• Seek to a position in milliseconds
• Toggle play and pause

​

Quick start

1. Register your local app with POST /register.
2. Poll GET /request-status?request_id=... until you receive an access_token.
3. Use Authorization: Bearer <token> (or access_token query param) for authenticated calls.
4. Connect to ws://127.0.0.1:39031/ws?access_token=<token> for real-time events.

curl -X POST http://127.0.0.1:39031/register \
  -H "Content-Type: application/json" \
  -d '{
    "app": {
      "name": "Game Launcher",
      "description": "Local game launcher that allows downloading and playing games",
      "developer": "CrickDevs",
      "website": "https://gamelauncher.crickdevs.com",
      "icon": "https://gamelauncher.crickdevs.com/icon.png"
    },
    "permissions": ["read", "write"]
  }'