curl --request POST \
  --url https://dashboard.lex-gpt.ai/api/rechtstipps \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "topic": "Kündigungsfristen im Mietrecht",
  "kind": "rechtstipp",
  "land": "AT"
}
'

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "created_at": "2023-11-07T05:31:56Z",
  "kind": "<string>",
  "topic": "<string>",
  "title": "<string>",
  "markdown": "<string>",
  "markdown_clean": "<string>",
  "markdown_tokenized": "<string>",
  "markdown_linked": "<string>",
  "html": "<string>",
  "html_linked": "<string>",
  "word_count": 123,
  "sources": [
    {
      "law_short": "ABGB",
      "section_id": "§ 1295",
      "title": "<string>",
      "category": "bundesrecht",
      "source_id": "<string>",
      "html_url": "<string>",
      "content": "<string>"
    }
  ],
  "citations": [
    {
      "index": 123,
      "marker": "§ 1295 ABGB",
      "label": "§ 1295 ABGB",
      "matched": true,
      "source_index": 123,
      "url": "<string>",
      "parts": [
        {
          "marker": "§ 30 IO",
          "matched": true,
          "source_index": 123,
          "url": "<string>"
        }
      ]
    }
  ]
}

{
  "detail": "<string>"
}

Rechtstipp

Rechtstipp oder Blogartikel erstellen

Generiert aus einem Thema einen recherchierten, SEO-tauglichen Artikel (österreichisches oder Schweizer Recht, je nach land), speichert ihn im Verlauf des Anwalts und gibt ihn inkl. id zurück. Die id verwendest du beim Feedback als target_id.

Die Paragraphen im Text sind über markdown_linked bereits als Links eingebettet. Minimal: nur topic + land senden — filters wird dann mit dem Land-Default gefüllt.

Dauer: die Recherche + Generierung braucht ~1 Minute — Timeout entsprechend großzügig setzen.

Auth: erfordert das WP-JWT des Anwalts (Service-Key → 403).

POST

rechtstipps

curl --request POST \
  --url https://dashboard.lex-gpt.ai/api/rechtstipps \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "topic": "Kündigungsfristen im Mietrecht",
  "kind": "rechtstipp",
  "land": "AT"
}
'

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "created_at": "2023-11-07T05:31:56Z",
  "kind": "<string>",
  "topic": "<string>",
  "title": "<string>",
  "markdown": "<string>",
  "markdown_clean": "<string>",
  "markdown_tokenized": "<string>",
  "markdown_linked": "<string>",
  "html": "<string>",
  "html_linked": "<string>",
  "word_count": 123,
  "sources": [
    {
      "law_short": "ABGB",
      "section_id": "§ 1295",
      "title": "<string>",
      "category": "bundesrecht",
      "source_id": "<string>",
      "html_url": "<string>",
      "content": "<string>"
    }
  ],
  "citations": [
    {
      "index": 123,
      "marker": "§ 1295 ABGB",
      "label": "§ 1295 ABGB",
      "matched": true,
      "source_index": 123,
      "url": "<string>",
      "parts": [
        {
          "marker": "§ 30 IO",
          "matched": true,
          "source_index": 123,
          "url": "<string>"
        }
      ]
    }
  ]
}

{
  "detail": "<string>"
}

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

stichpunkte

string

Optionale Stichpunkte des Anwalts, die der Artikel berücksichtigen soll (z. B. Unterthemen, Zielgruppe, Pflicht-Aspekte). Sie steuern die Schwerpunkte; rechtliche Aussagen bleiben an die interne Recherche gebunden. Leer/fehlend = Verhalten wie bisher.

Maximum string length: 1500

Example:

"- Sonderfall befristeter Vertrag\n- Zielgruppe Vermieter"

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 CH — DE liefert 400 (Roadmap).

Available options:

AT,

DE,

CH

filters

object

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

Show child attributes

as_of

string<date>

Optionaler Stichtag (YYYY-MM-DD). Derzeit pausiert: ein gesetzter Wert wird ignoriert, die Antwort basiert auf der aktuellen Rechtslage und enthält dann das Feld stichtag_hinweis.

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).

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[]

Show child attributes

citations

object[]

Show child attributes