API

Legt Nutzer + eigenen Tenant (Owner) an und liefert ein Bearer-Token. 14-Tage-Trial.

Parameter

Anfrage · application/json

{
  "email": "<email>",
  "password": "<string>",
  "name": "<string>"
}

Antworten

• 200 Token + Nutzerprofil ({token, access_token, token_type, user}).
• 422 E-Mail bereits vergeben oder ungültige Eingabe.

Liefert {token, user}. Bei aktivem TOTP ohne totp_code stattdessen {totp_required:true, challenge_token, expires_in}.

Parameter

Anfrage · application/json

{
  "email": "<email>",
  "password": "<string>",
  "totp_code": "<string>"
}

Antworten

• 200 {token,user} oder {totp_required,challenge_token,expires_in}.
• 401 Ungültige Zugangsdaten oder 2FA-Code.
• 403 Konto gesperrt.
• 429 Zu viele 2FA-Fehlversuche.

Parameter

Anfrage · application/json

{
  "challenge_token": "<string>",
  "code": "<string>"
}

Antworten

• 200 {token,user}.
• 401 Ungültig/abgelaufen.
• 429 Zu viele Versuche.

Parameter

Anfrage · application/json

{
  "email": "<email>"
}

Antworten

• 200 WebAuthn-publicKey-Request-Optionen (flach).

Parameter

Anfrage · application/json

{
  "id": "<string>",
  "response": {}
}

Antworten

• 200 {token,user}.
• 401 Challenge abgelaufen / Passkey unbekannt.
• 403 Konto gesperrt.

Parameter

Antworten

• 302 Weiterleitung (Browser-Navigation)
• 404 Unbekannter Provider.

Der State wird gegen das beim Redirect gesetzte Cookie geprüft. Im Fehlerfall ebenfalls 302, aber mit #error=… (state_missing, state_mismatch, no_code, exchange_failed, no_sub, email_unverified, account_disabled).

Parameter

Antworten

• 302 Redirect ins Frontend mit #token=…&provider=…(&new=1) im Fragment.

Alias derselben Verarbeitung für Provider mit response_mode=form_post. State und Code werden weiterhin aus der Query gelesen.

Parameter

Antworten

• 302 Redirect ins Frontend mit #token=… im Fragment.

Antworten

• 200 Nutzerprofil inkl. tenant (plan/status/trial_ends_at).
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)

Antworten

• 200 {ok:true}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)

Widerruft alle anderen Sessions. new_password braucht Bestätigung (new_password_confirmation).

Parameter

Anfrage · application/json

{
  "current_password": "<string>",
  "new_password": "<string>",
  "new_password_confirmation": "<string>"
}

Antworten

• 200 {ok:true}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 422 Aktuelles Passwort falsch.

Alle Bearer-Token des angemeldeten Nutzers, zuletzt genutzte zuerst. Die eigene Sitzung ist mit current:true markiert.

Antworten

• 200 {sessions:[{id, device, last_used_at, created_at, current}]}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)

Widerruft jedes Token außer dem aktuell verwendeten.

Antworten

• 200 {ok:true}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 429 Zu viele Anfragen (Rate-Limit)

Nur eigene Sitzungen; eine fremde ID trifft nichts und wird trotzdem mit 200 quittiert.

Parameter

Antworten

• 200 {ok:true}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 429 Zu viele Anfragen (Rate-Limit)

Antworten

• 200 {enabled, enabled_at, has_pending_secret, backup_codes_left}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)

Antworten

• 200 {secret, provisioning_uri} (otpauth://).
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 422 Bereits aktiviert.

Verifiziert den ersten Code und liefert die Backup-Codes EINMALIG im Klartext.

Parameter

Anfrage · application/json

{
  "code": "<string>"
}

Antworten

• 200 {enabled:true, backup_codes[]}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 422 Ungültiger Code / kein Pending-Secret.

Parameter

Anfrage · application/json

{
  "password": "<string>",
  "code": "<string>"
}

Antworten

• 200 {enabled:false}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 422 Passwort oder Code falsch.

Parameter

Anfrage · application/json

{
  "password": "<string>",
  "code": "<string>"
}

Antworten

• 200 {backup_codes[]}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 422 Validierungsfehler

Antworten

• 200 WebAuthn-publicKey-Create-Optionen (flach).
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)

Parameter

Anfrage · application/json

{
  "id": "<string>",
  "response": {},
  "name": "<string>"
}

Antworten

• 200 {ok:true, id, credential_name}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 422 Challenge/Attestation ungültig.

Antworten

• 200 {passkeys:[{id, credential_name, last_used_at, created_at}]}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)

Parameter

Anfrage · application/json

{
  "name": "<string>"
}

Antworten

• 200 {ok:true}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 404 Nicht gefunden (nicht vorhanden oder Ressource eines fremden Kontos)

Parameter

Antworten

• 200 {ok:true}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 404 Nicht gefunden (nicht vorhanden oder Ressource eines fremden Kontos)

Antworten

• 200 {providers:[…]}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)

Parameter

Antworten

• 200 {ok:true}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 422 Letzter Zugang ohne gesetztes Passwort.

Parameter

Anfrage · application/json

{
  "name": "<string>"
}

Antworten

• 200 {name}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 422 Validierungsfehler
• 429 Zu viele Anfragen (Rate-Limit)

Am Konto gespeichert und damit gerätübergreifend wirksam.

Parameter

Anfrage · application/json

{
  "language": "de"
}

Antworten

• 200 {language}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 422 Validierungsfehler
• 429 Zu viele Anfragen (Rate-Limit)

JSON-Download (Content-Disposition: attachment) mit Konto, Nutzern, Sites samt Seiten/Collections/Einträgen/Domains, Kontaktanfragen, Rechnungen und Medien-Metadaten des eigenen Kontos. Enthält bewusst keine Geheimnisse (Passwort-Hash, TOTP-Secret, Backup-Codes, Stripe-Referenzen). Rate-Limit 6/min.

Antworten

• 200 {meta, account, users, sites, contact_submissions, invoices, assets}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 422 Kein Konto (Tenant) am Nutzer hinterlegt.
• 429 Zu viele Anfragen (Rate-Limit)

seats.limit stammt aus dem Tarif; belegte Sitze = aktive Mitglieder plus offene, nicht abgelaufene Einladungen. Bei unbegrenzten Sitzen ist unlimited true und available null.

Antworten

• 200 {members:[{id,name,email,role,is_owner,is_you,joined_at}], invitations:[{id,email,role,expires_at,expired}], seats:{used,limit,unlimited,available,plan}, your_role, roles}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 422 Kein Konto (Tenant) am Nutzer hinterlegt.

Erfordert mindestens die Rolle admin; vergeben werden können nur Rollen unterhalb der eigenen. Eine bereits offene Einladung an dieselbe Adresse wird ersetzt. Die Einladung gilt 14 Tage; der Annahme-Link wird zusätzlich zurückgegeben, damit er auch ohne Mailzustellung weitergegeben werden kann. Rate-Limit 10/min.

Parameter

Anfrage · application/json

{
  "email": "<email>",
  "role": "admin"
}

Antworten

• 201 {invitation:{id,email,role,expires_at,expired}, accept_url}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 403 Rolle reicht nicht (forbidden) oder Zielrolle zu hoch (role_too_high).
• 422 already_member, email_taken, seat_limit_reached (mit limit) oder kein Tenant.
• 429 Zu viele Anfragen (Rate-Limit)

Erfordert mindestens die Rolle admin.

Parameter

Antworten

• 200 {ok:true}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 403 Rolle reicht nicht.
• 404 Nicht gefunden (nicht vorhanden oder Ressource eines fremden Kontos)
• 422 Kein Tenant.

Die eigene Rolle und die des Konto-Eigentümers sind nicht änderbar. Änderbar sind nur Mitglieder, deren aktuelle UND neue Rolle unterhalb der eigenen liegen.

Parameter

Anfrage · application/json

{
  "role": "admin"
}

Antworten

• 200 {ok:true, role}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 403 Rolle reicht nicht.
• 404 Mitglied nicht im eigenen Konto.
• 422 cannot_change_owner, cannot_change_self oder kein Tenant.

Entfernt Zugang und Konto des Mitglieds und widerruft dessen Token. Eigentümer und eigenes Konto sind ausgenommen.

Parameter

Antworten

• 200 {ok:true}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 403 Rolle reicht nicht.
• 404 Mitglied nicht im eigenen Konto.
• 422 cannot_remove_owner, cannot_remove_self oder kein Tenant.

Löst den Einmal-Token auf, damit die Annahme-Seite Team und Rolle anzeigen kann. Rate-Limit 12/min.

Parameter

Antworten

• 200 {email, role, team, expires_at}.
• 404 Token unbekannt (invalid).
• 410 Bereits angenommen (already_accepted) oder abgelaufen (expired).
• 429 Zu viele Anfragen (Rate-Limit)

Legt das Konto mit der eingeladenen Rolle an, löst den Token ein und liefert direkt ein Bearer-Token. Die E-Mail stammt aus der Einladung und gilt damit als bestätigt. Rate-Limit 12/min.

Parameter

Anfrage · application/json

{
  "token": "<string>",
  "name": "<string>",
  "password": "<string>"
}

Antworten

• 200 {token, access_token, token_type, user:{id,name,email,role,tenant_id}}.
• 404 Token unbekannt (invalid).
• 409 Für diese E-Mail existiert bereits ein Konto (email_taken).
• 410 Bereits angenommen oder abgelaufen.
• 422 Validierungsfehler
• 429 Zu viele Anfragen (Rate-Limit)

Antworten

• 200 {data:[Site]} inkl. theme, domains, pages_count.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)

Parameter

Anfrage · application/json

{
  "name": "<string>",
  "slug": "<string>",
  "theme_id": "<uuid>",
  "default_locale": "<string>",
  "locales": [],
  "company": {},
  "branding": {},
  "trust_bar": {},
  "xictraq_id": "<string>",
  "contact_endpoint": "<string>",
  "contact_recipient": "<string>",
  "google_verification": "<string>",
  "settings": {}
}

Antworten

• 201 {data:Site}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 422 Slug vergeben / ungültig.

Parameter

Antworten

• 200 {data:Site} inkl. pages, theme, domains.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 404 Nicht gefunden (nicht vorhanden oder Ressource eines fremden Kontos)

status und primary_domain_id sind bewusst NICHT hierüber setzbar (Publish- bzw. Domain-Flow).

Parameter

Anfrage · application/json

{
  "name": "<string>",
  "slug": "<string>",
  "theme_id": "<uuid>",
  "default_locale": "<string>",
  "locales": [],
  "company": {},
  "branding": {},
  "settings": {}
}

Antworten

• 200 {data:Site}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 404 Nicht gefunden (nicht vorhanden oder Ressource eines fremden Kontos)
• 422 Slug vergeben.

Parameter

Antworten

• 200 {deleted:true}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 404 Nicht gefunden (nicht vorhanden oder Ressource eines fremden Kontos)

Reiht einen Publish-Job ein und antwortet sofort. Status via GET /ai/generations/{generation_id}.

Parameter

Anfrage · application/json

{
  "label": "<string>",
  "notes": "<string>"
}

Antworten

• 202 {generation_id, status:"queued"}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 404 Nicht gefunden (nicht vorhanden oder Ressource eines fremden Kontos)

Header und Footer sind eigene System-Seiten (type=system) und tauchen daher nicht in GET /sites/{site}/pages auf. Dieser Endpunkt liefert ihre Seiten-IDs als Anker für den blockbasierten Header-/Footer-Editor; fehlende Regionsseiten werden beim ersten Aufruf angelegt.

Parameter

Antworten

• 200 {data:{header, footer}} — je Region eine Seiten-UUID.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 404 Nicht gefunden (nicht vorhanden oder Ressource eines fremden Kontos)

Parameter

Antworten

• 200 {data:[Page]} inkl. translations.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 404 Nicht gefunden (nicht vorhanden oder Ressource eines fremden Kontos)

Bilingual: translations je Locale ({locale,title,slug,…}).

Parameter

Anfrage · application/json

{
  "slug": "<string>",
  "path": "<string>",
  "type": "<string>",
  "status": "<string>",
  "template": "<string>",
  "parent_id": "<uuid>",
  "sort_order": 0,
  "is_home": false,
  "is_noindex": false,
  "seo": {},
  "translations": []
}

Antworten

• 201 {data:Page}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 404 Nicht gefunden (nicht vorhanden oder Ressource eines fremden Kontos)
• 422 Pfad vergeben / ungültig.

Parameter

Antworten

• 200 {data:Page} inkl. translations, sections, blocks.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 404 Nicht gefunden (nicht vorhanden oder Ressource eines fremden Kontos)

Parameter

Anfrage · application/json

{
  "slug": "<string>",
  "path": "<string>",
  "type": "<string>",
  "status": "<string>",
  "is_home": false,
  "is_noindex": false,
  "seo": {},
  "published_at": "<date-time>",
  "translations": []
}

Antworten

• 200 {data:Page}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 404 Nicht gefunden (nicht vorhanden oder Ressource eines fremden Kontos)
• 422 Validierungsfehler

Parameter

Antworten

• 200 {deleted:true}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 404 Nicht gefunden (nicht vorhanden oder Ressource eines fremden Kontos)

blocks: Liste von Block-IDs (Position = sort_order) oder Objekten {id,section_id,sort_order} für sektionsübergreifendes Verschieben.

Parameter

Anfrage · application/json

{
  "blocks": []
}

Antworten

• 200 {data:[Section]} inkl. sortierter Blöcke.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 404 Nicht gefunden (nicht vorhanden oder Ressource eines fremden Kontos)
• 422 Validierungsfehler

props werden gegen block_types.schema validiert (unbekannte Props -> 422).

Parameter

Anfrage · application/json

{
  "type": "<string>",
  "block_type_id": "<uuid>",
  "section_id": "<uuid>",
  "props": {},
  "content": {},
  "sort_order": 0,
  "is_visible": false
}

Antworten

• 201 {data:Block}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 404 Nicht gefunden (nicht vorhanden oder Ressource eines fremden Kontos)
• 422 Unbekannter Typ / Props verletzen das Schema.

Vollständiger Abgleich: Blöcke mit bekannter id werden aktualisiert, Einträge ohne id neu angelegt, alle nicht gesendeten Blöcke der Seite gelöscht. Die Reihenfolge im Array bestimmt die Reihenfolge auf der Seite. Blöcke mit unbekanntem oder deaktiviertem type werden übersprungen. Fehlt content, bleiben vorhandene Übersetzungen erhalten. Maximal 400 Blöcke je Aufruf.

Parameter

Anfrage · application/json

{
  "blocks": []
}

Antworten

• 200 {ok:true, blocks:[{id,type}], count}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 404 Nicht gefunden (nicht vorhanden oder Ressource eines fremden Kontos)
• 422 Validierungsfehler

Parameter

Anfrage · application/json

{
  "props": {},
  "content": {},
  "block_type_id": "<uuid>",
  "type": "<string>",
  "section_id": "<uuid>",
  "sort_order": 0,
  "is_visible": false
}

Antworten

• 200 {data:Block}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 404 Nicht gefunden (nicht vorhanden oder Ressource eines fremden Kontos)
• 422 Validierungsfehler

Parameter

Antworten

• 200 {deleted:true}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 404 Nicht gefunden (nicht vorhanden oder Ressource eines fremden Kontos)

Parameter

Antworten

• 200 {data:Theme} mit tokens.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 404 Kein Theme verfügbar.

Copy-on-Write: ein geteiltes System-Theme wird beim ersten Schreiben geklont.

Parameter

Anfrage · application/json

{
  "name": "<string>",
  "tokens": {}
}

Antworten

• 200 {data:Theme}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 404 Nicht gefunden (nicht vorhanden oder Ressource eines fremden Kontos)
• 422 Validierungsfehler

Parameter

Antworten

• 200 {data:[Asset]} (neueste zuerst) mit url, path, alt, title, width, height, bytes, mime.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 404 Nicht gefunden (nicht vorhanden oder Ressource eines fremden Kontos)

multipart/form-data. Nur Rasterformate (jpeg/png/webp/gif), max. 8 MB; SVG ist bewusst ausgeschlossen.

Parameter

Anfrage · multipart/form-data

{
  "file": "<binary>",
  "alt": "<string>"
}

Antworten

• 201 {url, path, bytes, mime, width, height, asset_id}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 404 Nicht gefunden (nicht vorhanden oder Ressource eines fremden Kontos)
• 422 Ungültige Datei.

Parameter

Anfrage · application/json

{
  "alt": "<string>",
  "title": "<string>"
}

Antworten

• 200 {data:Asset}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 404 Nicht gefunden (nicht vorhanden oder Ressource eines fremden Kontos)
• 422 Validierungsfehler

Parameter

Antworten

• 200 {deleted:true}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 404 Nicht gefunden (nicht vorhanden oder Ressource eines fremden Kontos)

Claude-Vision analysiert das Bild und schlägt Alt-Text + Titel vor. Rate-Limit 20/min.

Parameter

Antworten

• 200 {alt, title}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 402 Kontingent erschöpft — Upgrade oder Aufladen nötig
• 404 Nicht gefunden (nicht vorhanden oder Ressource eines fremden Kontos)
• 429 Zu viele Anfragen (Rate-Limit)

Parameter

Antworten

• 200 {data:[BlockType]} mit key, category, schema, default_props, preview_svg.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)

Parameter

Antworten

• 200 {data:[Collection]} mit name, fields-Schema, Eintragszahl.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 404 Nicht gefunden (nicht vorhanden oder Ressource eines fremden Kontos)

Parameter

Anfrage · application/json

{
  "name": "<string>",
  "slug": "<string>",
  "fields": []
}

Antworten

• 201 {data:Collection}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 404 Nicht gefunden (nicht vorhanden oder Ressource eines fremden Kontos)
• 422 Validierungsfehler

Parameter

Antworten

• 200 {data:Collection}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 404 Nicht gefunden (nicht vorhanden oder Ressource eines fremden Kontos)

Parameter

Anfrage · application/json

{
  "name": "<string>",
  "fields": []
}

Antworten

• 200 {data:Collection}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 404 Nicht gefunden (nicht vorhanden oder Ressource eines fremden Kontos)
• 422 Validierungsfehler

Parameter

Antworten

• 200 {deleted:true}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 404 Nicht gefunden (nicht vorhanden oder Ressource eines fremden Kontos)

Parameter

Antworten

• 200 {data:[Entry]} mit Feldwerten.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 404 Nicht gefunden (nicht vorhanden oder Ressource eines fremden Kontos)

Parameter

Anfrage · application/json

{
  "data": {}
}

Antworten

• 201 {data:Entry}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 404 Nicht gefunden (nicht vorhanden oder Ressource eines fremden Kontos)
• 422 Validierungsfehler

Parameter

Anfrage · application/json

{
  "data": {}
}

Antworten

• 200 {data:Entry}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 404 Nicht gefunden (nicht vorhanden oder Ressource eines fremden Kontos)
• 422 Validierungsfehler

Parameter

Antworten

• 200 {deleted:true}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 404 Nicht gefunden (nicht vorhanden oder Ressource eines fremden Kontos)

Parameter

Antworten

• 200 {data:[SiteVersion]} (neueste zuerst) mit label, created_at, Auslöser.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 404 Nicht gefunden (nicht vorhanden oder Ressource eines fremden Kontos)

Parameter

Anfrage · application/json

{
  "label": "<string>"
}

Antworten

• 201 {data:SiteVersion}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 404 Nicht gefunden (nicht vorhanden oder Ressource eines fremden Kontos)

Setzt die Site auf den Snapshot zurück. Der aktuelle Stand wird vorher automatisch als Version gesichert.

Parameter

Antworten

• 200 {ok:true, restored}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 404 Nicht gefunden (nicht vorhanden oder Ressource eines fremden Kontos)

Zusammengeführter Feed aus KI-Läufen, gesicherten Versionen und Hand-Edits (neueste zuerst).

Parameter

Antworten

• 200 {data:[Activity]} mit type, summary, created_at.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 404 Nicht gefunden (nicht vorhanden oder Ressource eines fremden Kontos)

Zwei-Phasen-Plan (nur lesend, keine Writes). Zusätzlich auf 30/min pro Nutzer gedrosselt.

Parameter

Anfrage · application/json

{
  "site_id": "<string>",
  "brief": "<string>",
  "lang": "<string>"
}

Antworten

• 200 {generation_id, blueprint:{sitemap,skeletons}, assistant_text, usage}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 402 Kontingent erschöpft — Upgrade oder Aufladen nötig
• 404 Site nicht gefunden.
• 422 Validierungsfehler
• 429 Zu viele Anfragen (Rate-Limit)

Reiht einen Build-Job ein (Dutzende KI-Calls) und antwortet sofort. brief ODER blueprint nötig.

Parameter

Anfrage · application/json

{
  "site_id": "<string>",
  "brief": "<string>",
  "blueprint": {},
  "lang": "<string>"
}

Antworten

• 202 {generation_id, status:"queued"}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 402 Kontingent erschöpft — Upgrade oder Aufladen nötig
• 404 Nicht gefunden (nicht vorhanden oder Ressource eines fremden Kontos)
• 422 Weder brief noch blueprint.
• 429 Zu viele Anfragen (Rate-Limit)

Interaktives Editieren via Tool-Calls. Antwort ist ein text/event-stream; Mutationen werden ggf. als pending_action zur Bestätigung ausgegeben.

Parameter

Anfrage · application/json

{
  "site_id": "<string>",
  "message": "<string>",
  "conversation_id": "<string>",
  "history": [],
  "lang": "<string>",
  "page_id": "<string>",
  "block_id": "<string>"
}

Antworten

• 200 Server-Sent-Events-Strom (text/event-stream): Events start, delta, tool_call_*, pending_action, done, error
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 402 Chat-Token-Kontingent erschöpft.
• 404 Nicht gefunden (nicht vorhanden oder Ressource eines fremden Kontos)
• 422 Validierungsfehler
• 429 Zu viele Anfragen (Rate-Limit)

Parameter

Antworten

• 200 Ergebnis der ausgeführten Aktion.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 404 Nicht gefunden / abgelaufen / kein Zugriff.
• 422 Validierungsfehler

Parameter

Anfrage · application/json

{
  "site_id": "<string>",
  "prompt": "<string>",
  "alt": "<string>",
  "aspect": "<string>",
  "premium": false
}

Antworten

• 200 Generiertes Asset (url/alt/…).
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 402 Kontingent erschöpft — Upgrade oder Aufladen nötig
• 404 Nicht gefunden (nicht vorhanden oder Ressource eines fremden Kontos)
• 422 Validierungsfehler
• 429 Zu viele Anfragen (Rate-Limit)

Überarbeitet einen markierten Text nach festem Kommando. Vorhandene ==Hervorhebungs==-Marker und Markdown bleiben erhalten; die Sprache des Textes wird beibehalten. Verbraucht eine ai_text-Einheit.

Parameter

Anfrage · application/json

{
  "site_id": "<string>",
  "text": "<string>",
  "command": "shorten",
  "lang": "<string>"
}

Antworten

• 200 {text, command, generation_id, usage}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 402 Kontingent erschöpft — Upgrade oder Aufladen nötig
• 404 Site nicht gefunden.
• 422 Ungültige Eingabe oder kein verwertbares Ergebnis.
• 429 Rate-Limit oder Kontingentsperre belegt (busy).
• 503 Textveredelung derzeit nicht verfügbar.

Erzeugt eine Wortmarke, ein Lockup oder ein Monogramm. Das Ergebnis wird serverseitig bereinigt (nur Vektor-Elemente, keine Skripte, keine externen Referenzen). Verbraucht eine ai_text-Einheit.

Parameter

Anfrage · application/json

{
  "site_id": "<string>",
  "text": "<string>",
  "variant": "wordmark",
  "primary": "<string>",
  "accent": "<string>",
  "hint": "<string>"
}

Antworten

• 200 {svg, variant, generation_id, usage}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 402 Kontingent erschöpft — Upgrade oder Aufladen nötig
• 404 Site nicht gefunden.
• 422 Ungültige Eingabe oder kein verwertbares SVG erhalten.
• 429 Rate-Limit oder Kontingentsperre belegt (busy).
• 503 Logo-Erzeugung derzeit nicht verfügbar.

Ruft eine öffentliche http(s)-Adresse serverseitig ab, wertet Titel, Meta-Beschreibung, og:site_name, theme-color und einen Textauszug aus und leitet daraus einen Markenvorschlag ab. Nicht öffentlich erreichbare Ziele werden abgelehnt. Verbraucht eine ai_text-Einheit.

Parameter

Anfrage · application/json

{
  "url": "<string>",
  "site_id": "<string>"
}

Antworten

• 200 {brand:{name,tagline,industry,tone,brand_voice,colors:{primary,accent},summary}, source_url, usage}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 402 Kontingent erschöpft — Upgrade oder Aufladen nötig
• 404 Site nicht gefunden (nur bei gesetzter site_id).
• 422 Adresse ungültig/nicht erreichbar oder kein verwertbares Ergebnis.
• 429 Rate-Limit oder Kontingentsperre belegt (busy).
• 503 Marken-Analyse derzeit nicht verfügbar.

Fortschritt von Build/Publish. Großzügiger Limiter (120/min) für sekündliches Polling.

Parameter

Antworten

• 200 {id, kind, status, output, error}; status queued|running|succeeded|failed.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 404 Nicht gefunden (nicht vorhanden oder Ressource eines fremden Kontos)

Synchron. Verbraucht eine ai_text-Einheit.

Parameter

Anfrage · application/json

{
  "count": 1
}

Antworten

• 200 {topics:[{title, angle, category, tags}]}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 402 Kontingent erschöpft — Upgrade oder Aufladen nötig
• 404 Nicht gefunden (nicht vorhanden oder Ressource eines fremden Kontos)
• 422 Validierungsfehler
• 429 Rate-Limit oder Kontingentsperre belegt (busy).
• 503 Themenvorschläge derzeit nicht verfügbar.

Reiht die Erzeugung ein und antwortet sofort. Fortschritt über GET /ai/generations/{generation}; bei status=succeeded trägt output {page_id, slug, title}. Der Beitrag entsteht als Seite mit type=post — Auflisten, Ändern und Löschen laufen über die Seiten-Endpunkte. Verbraucht eine ai_text-Einheit; schlägt der Lauf fehl, wird sie erstattet.

Parameter

Anfrage · application/json

{
  "topic": "<string>",
  "category": "<string>",
  "tags": [],
  "status": "draft",
  "publish_at": "<date>"
}

Antworten

• 202 {generation_id, status:"queued"}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 402 Kontingent erschöpft — Upgrade oder Aufladen nötig
• 404 Nicht gefunden (nicht vorhanden oder Ressource eines fremden Kontos)
• 422 Validierungsfehler
• 429 Rate-Limit oder Kontingentsperre belegt (busy).
• 500 Start fehlgeschlagen (dispatch_failed) — verbrauchte Credits werden erstattet.

Parameter

Antworten

• 200 {enabled, settings, knowledge, chat_tokens, embed}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 404 Nicht gefunden (nicht vorhanden oder Ressource eines fremden Kontos)

Aktivieren erfordert mindestens den Starter-Plan (Feature ai_chat).

Parameter

Anfrage · application/json

{
  "enabled": false,
  "settings": {}
}

Antworten

• 200 {enabled, settings, knowledge, embed}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 403 Plan reicht nicht (ai_chat).
• 404 Nicht gefunden (nicht vorhanden oder Ressource eines fremden Kontos)

Parameter

Antworten

• 200 {ok:true, knowledge}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 404 Nicht gefunden (nicht vorhanden oder Ressource eines fremden Kontos)
• 500 Neuaufbau fehlgeschlagen.

Antworten

• 200 {ok:true, service:"xicflow-assistant"}.

Antworten

• 200 JavaScript (application/javascript).
• 404 Skript nicht vorhanden.

Parameter

Antworten

• 200 {enabled, name, greeting, placeholder, locale, colors, branding} (enabled:false wenn nicht freigeschaltet).

Read-only, an der veröffentlichten Wissensbasis geerdet. Body als text/plain-JSON (CORS-simpel): {message, history?, conversation_id?, lang?}. Abrechnung gegen den Chat-Token-Pool des Site-Tenants.

Parameter

Anfrage · text/plain

{
  "message": "<string>",
  "history": [],
  "conversation_id": "<string>",
  "lang": "<string>"
}

Antworten

• 200 Server-Sent-Events-Strom (text/event-stream): Events start, delta, tool_call_*, pending_action, done, error
• 404 Assistent nicht verfügbar.
• 422 Leere/zu lange Nachricht.

Cross-Origin von veröffentlichten Sites (kein Token). Honeypot-Feld "website" muss leer bleiben; still-quittierend bei Spam/ungültig (kein Enumerationssignal). 10/min pro IP.

Parameter

Anfrage · text/plain

{
  "name": "<string>",
  "email": "<email>",
  "phone": "<string>",
  "message": "<string>",
  "url": "<string>",
  "website": "<string>"
}

Antworten

• 200 {ok:true} (immer, auch bei stillem Reject).
• 429 Zu viele Anfragen (Rate-Limit)

Parameter

Antworten

• 200 {data:[ContactSubmission]} (neueste zuerst, max. 500).
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 404 Nicht gefunden (nicht vorhanden oder Ressource eines fremden Kontos)

Parameter

Anfrage · application/json

{
  "status": "<string>"
}

Antworten

• 200 {data:ContactSubmission}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 404 Nicht gefunden (nicht vorhanden oder Ressource eines fremden Kontos)
• 422 Validierungsfehler

Parameter

Antworten

• 200 {deleted:true}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 404 Nicht gefunden (nicht vorhanden oder Ressource eines fremden Kontos)

text/csv (Semikolon-Delimiter + UTF-8-BOM, DE-Excel-tauglich). Custom-Formularfelder werden als zusätzliche Spalten ergänzt.

Parameter

Antworten

• 200 CSV-Datei (Content-Disposition: attachment).
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 404 Nicht gefunden (nicht vorhanden oder Ressource eines fremden Kontos)

Parameter

Antworten

• 200 {data:[Domain]} inkl. dns_instructions.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 404 Nicht gefunden (nicht vorhanden oder Ressource eines fremden Kontos)

Preview-Subdomains (*.xicflow.com) werden sofort verifiziert und gebunden.

Parameter

Anfrage · application/json

{
  "host": "<string>",
  "is_primary": false,
  "redirect_to": "<string>"
}

Antworten

• 201 {data:Domain, bind}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 403 Custom-Domain-Limit erreicht.
• 404 Nicht gefunden (nicht vorhanden oder Ressource eines fremden Kontos)
• 422 Host bereits registriert / ungültig.

Parameter

Antworten

• 200 {verified:true, data:Domain}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 404 Nicht gefunden (nicht vorhanden oder Ressource eines fremden Kontos)
• 422 Noch nicht verifiziert (reason/checked).

Fährt die State-Machine (Plesk-Alias + LE + nginx-Map). Vorbedingung: verifiziert.

Parameter

Antworten

• 200 {ok:true, state:"live", steps}.
• 202 Angenommen — läuft weiter (DNS noch nicht aufgelöst / manueller Schritt).
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 404 Nicht gefunden (nicht vorhanden oder Ressource eines fremden Kontos)
• 409 Noch nicht verifiziert.
• 422 Fehlerzustand.

Parameter

Antworten

• 200 {ok:true, detach}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 404 Nicht gefunden (nicht vorhanden oder Ressource eines fremden Kontos)

Antworten

• 200 {plan, quotas, used, remaining, ai_credits, chat_tokens} (-1 = unbegrenzt).
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)

Antworten

• 200 {publicKey, mode, currentPlan, hasSubscription, prices}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)

Abo-Tarife (Starter/Pro/Premium/Agentur), Credit- und Chat-Token-Pakete. Preise NETTO in Cent + EUR.

Antworten

• 200 {currentPlan, currency, plans, creditPacks, creditBalance, chatTokenPacks, chatTokens}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)

target steuert die Variante: plan (Default, mode=subscription) | credits | chat_tokens (mode=payment). Aktives Abo -> sofortiges In-Place-Upgrade mit Proration.

Parameter

Anfrage · application/json

{
  "target": "<string>",
  "plan": "<string>",
  "interval": "<string>",
  "pack": "<string>"
}

Antworten

• 200 {sessionId, url} oder {switched:true, plan} bei In-Place-Upgrade.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 422 Kein Tenant / unbekanntes Paket / ungültige Eingabe.

Antworten

• 200 {url}.
• 400 Kein Stripe-Konto.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)

Antworten

• 200 {active, status, plan, current_period_end, cancel_at_period_end, next_charge_amount, interval …}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)

Antworten

• 200 {invoices:[…]}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)

Nur Rechnungen des eigenen Kontos. Der Dateiname ist die Rechnungsnummer.

Parameter

Antworten

• 200 PDF-Datei (application/pdf, Content-Disposition: attachment).
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 404 Rechnung nicht gefunden, ohne PDF oder Datei nicht vorhanden (file_missing).

Standard zum Periodenende; ?immediate=true kündigt sofort.

Parameter

Antworten

• 200 {ok:true, status, cancel_at_period_end, current_period_end}.
• 400 Kein Tenant / keine Subscription.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 500 Serverfehler

Antworten

• 200 {ok:true, cancel_at_period_end:false}.
• 400 Keine Subscription.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 500 Serverfehler

Antworten

• 200 {addons}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)

Parameter

Anfrage · application/json

{
  "addons": []
}

Antworten

• 200 {sessionId, url}.
• 401 Nicht authentifiziert (fehlendes oder ungültiges Bearer-Token)
• 422 Kein Tenant / unbekanntes Add-on.

Kein Bearer-Token. Signatur über Stripe-Signature-Header; Idempotenz via stripe_events. Roh-Body erforderlich.

Antworten

• 200 {received:true}.
• 400 Signatur fehlt/ungültig.
• 500 Kein Webhook-Secret konfiguriert.