Projects-Settings-API

Die Projects-Settings-API verwaltet die projektbezogenen Einstellungen, die das Verhalten der Module steuern — Goals, aktive Module, Brand-Voice-Profile, Integrations-Bindings. Das reine Project-CRUD (/v1/projects) ist in Projekte-API dokumentiert; hier geht es um die Settings-Layer drumherum.

Alle Endpoints unter /v1/..., Sanctum-authentifiziert, team-scoped.

Goals

Goals sind messbare Ziele eines Projekts (z.B. "Top-3 fuer 'best crm'", "10 Backlinks bis Q3"). Module wie das Action-Center und das Reporting konsumieren sie als Optimierungs-Anker.

curl -X POST "$BASE/goals" \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{"project_id":7,"type":"keyword_top3","target":"best crm","deadline":"2026-09-01"}'

Module-Aktivierung

Jedes Projekt hat einen Satz aktivierbarer Module (Backlinks, AVI, Site-Audit, Rank-Tracker ...). Inaktive Module liefern in der UI 403 und in der API 409 {error:"module_inactive"}.

# Backlinks-Modul aktivieren
curl -X POST "$BASE/modules/backlinks/activate" \
  -H "Authorization: Bearer $TOKEN"

{
  "data": {
    "module": "backlinks",
    "active": true,
    "activated_at": "2026-05-01T09:14:01Z"
  }
}

Action-Center-Goal-Profil

Das Goal-Profile ist die strategische Klammer eines Projekts (Industry, Persona, North-Star-Metric). Action-Center, AI-Tools und das Reporting beziehen sich darauf.

Webhooks

Webhook-Settings pro Team — Events werden bei Job-Abschluss (Article ready, Report completed, AVI checked) gefeuert. Schema und Endpoint-Definition: Webhooks-API.

Auf Settings-Seite relevant:

• Webhook-URL ist team-scoped, nicht project-scoped — alle Projekte feuern gegen denselben Endpoint.
• Pro-Event-Filter (subscribed_events[]) ist als Webhook-Property pflegbar.

Integrations

Externe Integrationen (Google Search Console, GA4, Review-Sources, CMS) werden ueber dedizierte Sub-APIs verwaltet, ihre Bindings tauchen aber als Project-Setting auf:

Pro Projekt kann es eine GSC-Property und eine GA4-Property gegeben — Mehrfach-Bindings liefern 409 Conflict.

# GSC-Property an Project linken
curl -X POST "$BASE/google/gsc/properties/$PROP/link" \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{"project_id":7}'

Brand-Voice & Style

Brand-Voice-Profile (style_profile) und Content-Goals werden global pro Team verwaltet, dann beim Article-Generate per ID referenziert. Details inkl. Felder: Artikel-API.

Status-Codes

Pitfalls

• Module-Deactivate stoppt keine laufenden Jobs. Wenn du ein Modul deaktivierst, laufen bereits dispatched-te Jobs zu Ende. Cancel ueber Job-Status-Endpoints.
• Goal-Profile ist Voraussetzung fuer Action-Center. Ohne goal_profile liefern /v1/action-center/path und /todos leere Arrays — kein Fehler, aber auch kein Output.
• GSC-Link braucht OAuth-Connection. Der Link-Call schlaegt mit 409 fehl, wenn keine google/connections-Verbindung existiert.

Verwandt: Projekte-API · Webhooks-API · Credits-API.