Skip to main content

Documentation Index

Fetch the complete documentation index at: https://rocks.docs.rive.wtf/llms.txt

Use this file to discover all available pages before exploring further.

Every API key is tied to one IP. To apply for a key, DM southctrl on Discord.
Use the endpoint path below, replace the required params, and send Authorization: Bearer YOUR_API_KEY.

​
Quick Start

1

Call the endpoint

Send a request to the random question route.
2

Read the question

response returns a Would You Rather prompt you can show directly.
3

Use it in your app

Great for chat prompts, bots, and games.
This is one of the simplest endpoints in the API.

​
Get Random Question

Retrieve a random “Would You Rather” question.

​
Endpoint

GET /api/wouldyourather

​
Example Request

curl -X GET "https://rocks.rive.wtf/api/wouldyourather" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Example Response

{
  "id": "l4hve5efmn2k",
  "pack": null,
  "question": "Would you rather have super-human memory or teleportation?",
  "rating": "PG",
  "translations": {
    "bn": "আপনি কি বরং সুপার-হিউম্যান মেমরি বা টেলিপোর্টেশন পছন্দ করবেন?",
    "de": "Möchtest du lieber übermenschliches Gedächtnis oder Teleportation?",
    "es": "¿Prefieres la memoria sobrehumana o la teletransportación?",
    "fr": "Vous préférez la mémoire surhumaine ou la téléportation ?",
    "hi": "क्या आप सुपर-ह्यूमन मेमोरी या टेलीपोर्टेशन चाहेंगे?",
    "tl": "Mas gugustuhin mo ba ang super-human memory o teleportation?"
  },
  "type": "WYR"
}

​
Response Fields

​
id
string
Unique identifier for the question
​
question
string
“Would You Rather” question text
​
pack
string | null
Question pack/collection identifier (null if not part of a specific pack)
​
rating
string
Content rating for the question (e.g., “PG”, “PG-13”)
​
type
string
Question type identifier (typically “WYR” for Would You Rather)
​
translations
object
Translations of the question in multiple languages
Perfect for Discord bots, icebreaker games, and conversation starters! Each request returns a different random question with multi-language support.
Questions are family-friendly with PG and PG-13 ratings. database contains hundreds of unique questions with translations in 6 languages.

​
Use Cases

Discord Bot Commands

Add an engaging /wyr command to your bot

Icebreaker Games

Start conversations in social settings

Team Building

Use in corporate team-building activities

Content Creation

Generate discussion topics for social media