api-referenceDEL
DELETEhttps://analytics.flowsery.com/api/v1/goals

Benutzerdefinierte Zielereignisse nach Besucher, Ereignisname oder innerhalb eines Datumsbereichs loeschen.

API-Schluessel (Bearer-Token)

Mindestens ein Filter erforderlich

Mindestens ein Abfrageparameter muss angegeben werden. Der Aufruf dieses Endpunkts ohne Filter gibt einen 400-Fehler zurueck.

Abfrageparameter

ParameterTypBeschreibung
visitorIdstringZiele entfernen, die an eine bestimmte Besucher-ID gebunden sind.
namestringZiele entfernen, die einem bestimmten Ereignisnamen entsprechen (z. B. signup, purchase).
startAtstringISO 8601 Startzeitstempel (z. B. 2024-01-01T00:00:00Z).
endAtstringISO 8601 Endzeitstempel (z. B. 2024-01-31T23:59:59Z).

Loeschverhalten

<strong>Nur Zeitraum:</strong> Entfernt alle Ziele innerhalb dieses Zeitraums.

<strong>Nur Besucher-ID:</strong> Entfernt alle Ziele fuer diesen Besucher (gesamter Zeitraum).

<strong>Nur Name:</strong> Entfernt alle Ziele mit diesem Namen (gesamter Zeitraum).

<strong>Besucher-ID + Name:</strong> Entfernt Ziele, die beiden Kriterien entsprechen.

<strong>Zeitraum + Filter:</strong> Entfernt Ziele, die den Filtern innerhalb des angegebenen Zeitfensters entsprechen.

Die Angabe von <code>visitorId</code> oder <code>name</code> ohne Zeitraum loescht ALLE uebereinstimmenden Datensaetze ueber den gesamten Verlauf.

Fehlerantworten

<strong>400 Bad Request</strong> -- Es wurden keine Filterparameter angegeben.

<strong>401 Unauthorized</strong> -- API-Schluessel fehlt oder ist ungueltig.

Nach Name innerhalb eines Zeitraums loeschen
curl -X DELETE "https://analytics.flowsery.com/api/v1/goals?name=signup&startAt=2024-01-01T00:00:00Z&endAt=2024-01-31T23:59:59Z" \
  -H "Authorization: Bearer flow_sk_live_abc123"
Alle Ziele eines Besuchers loeschen
curl -X DELETE "https://analytics.flowsery.com/api/v1/goals?visitorId=a3ab2331-989f-4cfa-91c6-2461c9e3c6bd" \
  -H "Authorization: Bearer flow_sk_live_abc123"
200
{
  "status": "success",
  "data": [
    {
      "deleted": 14,
      "message": "Goal events deleted successfully"
    }
  ]
}