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

Verwijder aangepaste goal-events per bezoeker, eventnaam of binnen een datumbereik.

Bearer-token (werkruimtetoken of website-API-sleutel)

Werkruimtetokens hebben een websiteselector nodig

Werkruimte-API-tokens hebben toegang tot elke website in de werkruimte. Geef websiteId of domain mee, zodat Flowsery weet welke website je wilt opvragen of wijzigen. Website-API-sleutels horen al bij één website, dus daar kun je de selector weglaten.

Websiteselector

ParameterTypeBeschrijving
websiteIdstringWebsite-ID om te gebruiken met een werkruimte-API-token. Laat weg als je authenticeert met een website-API-sleutel.
domainstringWebsitedomein om te gebruiken met een werkruimte-API-token als er geen websiteId is opgegeven. Laat weg als je authenticeert met een website-API-sleutel.

Minstens één filter verplicht

Je moet minstens één queryparameter meegeven. Dit endpoint aanroepen zonder filters geeft een 400-fout.

Queryparameters

ParameterTypeBeschrijving
visitorIdstringVerwijder goals die bij een specifieke bezoekers-ID horen.
namestringVerwijder goals met een specifieke eventnaam (bijv. signup, purchase).
startAtstringStarttijdstempel in ISO 8601 (bijv. 2024-01-01T00:00:00Z).
endAtstringEindtijdstempel in ISO 8601 (bijv. 2024-01-31T23:59:59Z).

Hoe verwijderen werkt

<strong>Alleen tijdsbereik:</strong> verwijdert elke goal binnen die periode.

<strong>Alleen bezoekers-ID:</strong> verwijdert alle goals van die bezoeker (ooit).

<strong>Alleen naam:</strong> verwijdert alle goals met die naam (ooit).

<strong>Bezoekers-ID + naam:</strong> verwijdert goals die aan beide voldoen.

<strong>Tijdsbereik + filters:</strong> verwijdert goals die binnen het opgegeven venster aan de filters voldoen.

Geef je visitorId of name op zonder tijdsbereik, dan worden ALLE overeenkomende records uit de hele geschiedenis verwijderd.

Foutantwoorden

<strong>400 Bad Request</strong> -- Er zijn geen filterparameters opgegeven.

<strong>401 Unauthorized</strong> -- Het API-token ontbreekt, is ongeldig of verlopen, of wordt niet geaccepteerd voor dit endpoint.

Verwijderen op naam binnen een datumbereik
curl -X DELETE "https://analytics.flowsery.com/analytics/api/v1/goals?websiteId=flid_abc123&name=signup&startAt=2024-01-01T00:00:00Z&endAt=2024-01-31T23:59:59Z" \
  -H "Authorization: Bearer <workspace-or-website-token>"
Alle goals van een bezoeker verwijderen
curl -X DELETE "https://analytics.flowsery.com/analytics/api/v1/goals?websiteId=flid_abc123&visitorId=a3ab2331-989f-4cfa-91c6-2461c9e3c6bd" \
  -H "Authorization: Bearer <workspace-or-website-token>"
200
{
  "status": "success",
  "data": [
    {
      "deleted": 14,
      "message": "Goal completions deleted successfully"
    }
  ]
}