Verba Plugin profile

Joke API

Fetch one joke from JokeAPI.

joke_api Version 1.1.0
When to use

Best-fit scenarios

Use when the user asks for a joke.

How to call it

Execution guidance

Call the tool with no arguments to fetch one joke. If the user wants a themed or rewritten joke, fetch the joke first and then transform it outside the plugin.

Arguments

Input shape

This Verba Plugin currently exposes no explicit argument fields in its usage metadata.

Settings

Required configuration

  • JOKEAPI_DEFAULT_LANGUAGE string

    JokeAPI language code (for example: en, es, de, fr, pt, cs).

    Default: en
  • JOKEAPI_DEFAULT_SAFE_MODE checkbox

    If enabled, apply JokeAPI safe-mode and strict blacklist by default.

    Default: True
  • JOKEAPI_TIMEOUT_SECONDS number

    Timeout for JokeAPI HTTP calls.

    Default: 10
Example call

Canonical usage JSON

{
  "function": "joke_api",
  "arguments": {}
}