API Keys

API keys are the primary credential for accessing the Rad TV API. Use them for GraphQL queries, MCP connections, and file uploads.

Generating an API Key

Generate your API key from Developer Settings:

1. Sign in and open Developer Settings
2. Click Generate API Key
3. Copy the key into your secret store

Developer Settings can reveal and copy your current key again. If the key is exposed or should no longer be trusted, select Regenerate. The old key stops working immediately, so update every connected application with the replacement.

Using Your API Key

Include the key as a Bearer token in all API requests:

Authorization: Bearer YOUR_API_KEY

Your API key works everywhere:

• GraphQL — queries and mutations at POST /graphql
• MCP — connect AI agents at POST /mcp
• File uploads — upload video and image assets

Verify It Works

After generating your key, confirm it's working:

curl -X POST https://api.rad.live/graphql \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"query": "{ verifyConnection { authenticated user { username } channel { id name } subscription { plan state } permissions } }"}'

A successful response identifies the account, channel, active subscription, and permissions:

{
  "data": {
    "verifyConnection": {
      "authenticated": true,
      "user": { "username": "mychannel" },
      "channel": {
        "id": "did:rad.live:channel/xyz789",
        "name": "My Channel"
      },
      "subscription": {
        "plan": "Premium",
        "state": "ACTIVE"
      },
      "permissions": ["content:read", "content:create"]
    }
  }
}

Next steps

• Quickstart — Make your first API call
• Identifiers — Understand how resources are addressed