Chat API

Work with chat history and send messages on behalf of authorized users.

List Messages

GET /v1/chat/messages?room_name=<room>

Required scope: chat:read

curl "https://api.8ball.live/v1/chat/messages?room_name=creator-id" \
  -H "Authorization: Bearer 8b_key_..."

Send Message

POST /v1/chat/messages

Required scope: chat:write (user OAuth token)

curl -X POST https://api.8ball.live/v1/chat/messages \
  -H "Authorization: Bearer 8b_at_..." \
  -H "Content-Type: application/json" \
  -d '{"room_name":"creator-id","content":"Hello chat!"}'

Delete Message

DELETE /v1/chat/:message_id

Required scope: chat:write

curl -X DELETE https://api.8ball.live/v1/chat/message-id \
  -H "Authorization: Bearer 8b_at_..."