Skip to main content
POST

Authorizations

Authorization
string
header
required

Authorization: Bearer <TOKEN>. Für den Tipp-Lebenszyklus (/rechtstipps) ist <TOKEN> das finditoo-WP-JWT des eingeloggten Anwalts (ein Service-Key wird hier mit 403 abgewiesen). /feedback und /rechtstipp/options akzeptieren zusätzlich einen Service-Key (Maschine-zu-Maschine). Behandle Tokens als Secret; niemals in Chats/Slack teilen.

Body

application/json
topic
string
required

Thema/Fragestellung.

Example:

"Kündigungsfristen im Mietrecht"

kind
enum<string>
default:rechtstipp

rechtstipp (kurz, Endkunden) oder blog (länger, Fachpublikum).

Available options:
rechtstipp,
blog
land
enum<string>
default:AT

Rechtsordnung + Wording. ISO-Code bevorzugt; Alt-Freitext ("Österreich"/"Schweiz") wird toleriert. Steuert NICHT die Retrieval-Jurisdiktion (das macht filters.geographic). Verfügbar: AT und CHDE liefert 400 (Roadmap).

Available options:
AT,
DE,
CH
filters
object

Retrieval-Scope (Jurisdiktion etc.). Wird weggelassen → Land-Default.

as_of
string<date>

Optionaler Stichtag (YYYY-MM-DD).

Example:

"2026-07-23"

Response

Erstellter & gespeicherter Artikel (inkl. id)

Antwort von POST /rechtstipps (alle Generator-Felder PLUS id/created_at). Die fertig verlinkten Varianten (markdown_linked, html_linked) gibt es nur hier auf der Erstellen-Response; markdown_tokenized + citations werden gespeichert und kommen auch bei GET/PATCH zurück (RechtstippStored).

id
string<uuid>

Tipp-ID → beim Feedback als target_id.

created_at
string<date-time>
kind
string
topic
string
title
string

Generierte H1.

markdown
string

Artikel MIT Quellen-Markern ([§ …]).

markdown_clean
string

Artikel OHNE Marker (Veröffentlichung/Kopieren).

markdown_tokenized
string

Marker durch {{CITATION_n}} ersetzt (für granulare Integration).

markdown_linked
string

Artikel mit Paragraphen bereits als [Label](URL) eingebettet — der einfachste Weg zu verlinkten Paragraphen. Hinweis: die Auflösung greift aktuell für AT-Quellen (RIS/EUR-Lex); bei CH bleiben Marker derzeit überwiegend unverlinkt (Fedlex-Verlinkung in Arbeit).

html
string

Minimal-HTML (marker-frei).

html_linked
string

HTML mit eingebetteten Paragraphen-Links.

word_count
integer
sources
object[]
citations
object[]