API Docs.

1. Schnellstart

In 30 Sekunden zur ersten Pointe.

# 1. SDK installieren
npm install @deinmutter/sdk

# 2. API-Key holen
# Frag deine Mutter, sie hat ihn auf einem Zettel.

# 3. Witz generieren
const witz = await mama.jokes.next();
console.log(witz.text);

2. Authentifizierung

Alle Anfragen erfordern einen API-Key im Header Authorization: Bearer <key>. API-Keys haben das Format mama_live_xxxxxxxxxxxx oder mama_test_xxxxxxxxxxxx.

3. Endpoints

GET /v2/jokes/next

Liefert den nächsten Witz aus dem aktiven Kanal.

// Request
GET https://api.deinmutter.de/v2/jokes/next?category=fett

// Response 200
{
  "id": "jk_8h3k2l9m",
  "category": "fett",
  "text": "Deine Mutter ist so fett, ihr Schatten hat eine eigene Postleitzahl.",
  "intensity": 0.84,
  "language": "de-DE",
  "warnings": []
}

POST /v2/roast

Erstellt einen personalisierten Roast. Kostet pro Anfrage 0,4 Mutter-Credits.

// Request
POST https://api.deinmutter.de/v2/roast
{
  "name": "Klaus",
  "context": "Familienfeier",
  "intensity": 0.6
}

// Response 200
{
  "id": "rst_92kk1l4z",
  "text": "Klaus, deine Mutter ist so deutsch, sie hat dein Geburtsdatum dem Finanzamt pünktlicher gemeldet als dir.",
  "delivery_eta": "sofort"
}

GET /v2/mothers/{id}

Liest Metadaten einer Mutter aus der MutterDB.

// Response 200
{
  "id": "mom_helga_64",
  "first_name": "Helga",
  "tendency_to_call": "hoch",
  "favorite_phrase": "Hast du gegessen?",
  "last_seen": "2026-04-28T14:32:00Z"
}

4. Fehlercodes

• 401 · Unauthorized — Mutter hat dich nicht erkannt.
• 403 · Forbidden — Mutter sagt nein.
• 404 · Not Found — Mutter ist gerade beim Aldi.
• 418 · I'm a Teapot — Mutter macht gerade Kaffee.
• 429 · Too Many Requests — Mutter braucht Pause.
• 500 · Internal Mutter Error — Anrufen Sie sie.

5. SDKs

• TypeScript: @deinmutter/sdk
• Python: pip install deinmutter
• Go: go get github.com/deinmutter/go-sdk
• Rust: cargo add deinmutter
• Bayrisch: brew install muada
• COBOL: auf Anfrage (Helgas Mutter pflegt diesen Branch persönlich)