Skip to content
ToolsOnDuty - free online tools
ToolsOnDuty / docs
Browse documentation

Reference / Entertainment

Entertainment API

10 endpoints for entertainment workflows. Every call requires bearer authentication and uses the standard ToolsOnDuty response envelope.

Try it

Runs a real request from your browser to your own ToolsOnDuty account. Your key is only kept in this page and is never stored.

POST/v1/entertainment/magic-8-ball1 credit / call

Magic 8-Ball

Return a randomized classic-style response to a yes-or-no question for entertainment.

ParameterTypeRequiredDescription
questionstringYesYes-or-no question.

Request

curl -X POST https://toolsonduty.com/api/v1/entertainment/magic-8-ball \
  -H "Authorization: ******" \
  -H "Content-Type: application/json" \
  -d '{"question":"Will the release go well?"}'

Response

{
  "ok": true,
  "data": {
    "answer": "Signs point to yes",
    "entertainmentOnly": true
  }
}
POST/v1/entertainment/truth-or-dare1 credit / call

Truth or Dare prompt

Return a randomized, non-harmful truth question or dare prompt for casual entertainment.

ParameterTypeRequiredDescription
modestringNotruth | dare | random. Default: random.

Request

curl -X POST https://toolsonduty.com/api/v1/entertainment/truth-or-dare \
  -H "Authorization: ******" \
  -H "Content-Type: application/json" \
  -d '{"mode":"truth"}'

Response

{
  "ok": true,
  "data": {
    "mode": "truth",
    "prompt": "What is a skill you wish you had?",
    "safety": "Skip anything uncomfortable."
  }
}
POST/v1/entertainment/advice1 credit / call

Advice generator

Generate concise general-purpose advice from a curated local collection.

ParameterTypeRequiredDescription
categorystringNomixed | everyday | creative | learning | adventure. Default: mixed.
countnumberNoNumber of unique results (1-8). Default: 3.

Request

curl -X POST https://toolsonduty.com/api/v1/entertainment/advice \
  -H "Authorization: ******" \
  -H "Content-Type: application/json" \
  -d '{"category":"learning","count":2}'

Response

{
  "ok": true,
  "data": {
    "advice": [
      "Break a large task into the smallest useful next action."
    ],
    "count": 2
  }
}
POST/v1/entertainment/bucket-list1 credit / call

Bucket-list generator

Generate practical bucket-list ideas across adventure, learning, creativity and everyday life.

ParameterTypeRequiredDescription
categorystringNomixed | everyday | creative | learning | adventure. Default: mixed.
countnumberNoNumber of unique results (1-8). Default: 3.

Request

curl -X POST https://toolsonduty.com/api/v1/entertainment/bucket-list \
  -H "Authorization: ******" \
  -H "Content-Type: application/json" \
  -d '{"category":"adventure","count":2}'

Response

{
  "ok": true,
  "data": {
    "ideas": [
      "Watch a sunrise from a place you have never visited."
    ],
    "count": 2
  }
}
POST/v1/entertainment/charades1 credit / call

Charades generator

Generate family-friendly charades prompts without copyrighted character or movie lists.

ParameterTypeRequiredDescription
categorystringNomixed | everyday | creative | learning | adventure. Default: mixed.
countnumberNoNumber of unique results (1-8). Default: 3.

Request

curl -X POST https://toolsonduty.com/api/v1/entertainment/charades \
  -H "Authorization: ******" \
  -H "Content-Type: application/json" \
  -d '{"category":"creative","count":2}'

Response

{
  "ok": true,
  "data": {
    "prompts": [
      "Conducting an orchestra"
    ],
    "count": 2
  }
}
POST/v1/entertainment/compliments1 credit / call

Compliment generator

Generate positive, respectful compliments from a curated local collection.

ParameterTypeRequiredDescription
categorystringNomixed | everyday | creative | learning | adventure. Default: mixed.
countnumberNoNumber of unique results (1-8). Default: 3.

Request

curl -X POST https://toolsonduty.com/api/v1/entertainment/compliments \
  -H "Authorization: ******" \
  -H "Content-Type: application/json" \
  -d '{"category":"creative","count":2}'

Response

{
  "ok": true,
  "data": {
    "compliments": [
      "Your perspective makes familiar ideas feel fresh."
    ],
    "count": 2
  }
}
POST/v1/entertainment/never-have-i-ever1 credit / call

Never Have I Ever generator

Generate clean, family-friendly Never Have I Ever prompts.

ParameterTypeRequiredDescription
categorystringNomixed | everyday | creative | learning | adventure. Default: mixed.
countnumberNoNumber of unique results (1-8). Default: 3.

Request

curl -X POST https://toolsonduty.com/api/v1/entertainment/never-have-i-ever \
  -H "Authorization: ******" \
  -H "Content-Type: application/json" \
  -d '{"category":"adventure","count":2}'

Response

{
  "ok": true,
  "data": {
    "prompts": [
      "Never have I ever slept under the stars."
    ],
    "count": 2
  }
}
POST/v1/entertainment/pictionary1 credit / call

Pictionary generator

Generate family-friendly drawing prompts by difficulty.

ParameterTypeRequiredDescription
difficultystringNomixed | easy | medium | hard. Default: mixed.
countnumberNoNumber of unique prompts (1-9). Default: 3.

Request

curl -X POST https://toolsonduty.com/api/v1/entertainment/pictionary \
  -H "Authorization: ******" \
  -H "Content-Type: application/json" \
  -d '{"difficulty":"medium","count":2}'

Response

{
  "ok": true,
  "data": {
    "prompts": [
      "Treasure map"
    ],
    "count": 2
  }
}
POST/v1/entertainment/random-facts1 credit / call

Random-facts generator

Return concise facts from a reviewed local collection.

ParameterTypeRequiredDescription
categorystringNomixed | everyday | creative | learning | adventure. Default: mixed.
countnumberNoNumber of unique results (1-8). Default: 3.

Request

curl -X POST https://toolsonduty.com/api/v1/entertainment/random-facts \
  -H "Authorization: ******" \
  -H "Content-Type: application/json" \
  -d '{"category":"learning","count":2}'

Response

{
  "ok": true,
  "data": {
    "facts": [
      "Octopuses have three hearts."
    ],
    "count": 2
  }
}
POST/v1/entertainment/trivia1 credit / call

Trivia generator

Generate question-and-answer trivia from a reviewed local collection.

ParameterTypeRequiredDescription
categorystringNomixed | science | geography | history | technology. Default: mixed.
countnumberNoNumber of unique questions (1-8). Default: 3.

Request

curl -X POST https://toolsonduty.com/api/v1/entertainment/trivia \
  -H "Authorization: ******" \
  -H "Content-Type: application/json" \
  -d '{"category":"science","count":2}'

Response

{
  "ok": true,
  "data": {
    "questions": [
      {
        "question": "What gas do plants absorb during photosynthesis?",
        "answer": "Carbon dioxide"
      }
    ],
    "count": 2
  }
}