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

Delete custom goal events by visitor, event name, or within a date range.

Bearer Token (API key)

At least one filter required

At least one query parameter must be provided. Calling this endpoint with no filters returns a 400 error.

Query parameters

ParameterTypeDescription
visitorIdstringRemove goals tied to a specific visitor ID.
namestringRemove goals matching a specific event name (e.g., signup, purchase).
startAtstringISO 8601 start timestamp (e.g., 2024-01-01T00:00:00Z).
endAtstringISO 8601 end timestamp (e.g., 2024-01-31T23:59:59Z).

Deletion behavior

<strong>Time range only:</strong> Removes every goal within that period.

<strong>Visitor ID only:</strong> Removes all goals for that visitor (all time).

<strong>Name only:</strong> Removes all goals with that name (all time).

<strong>Visitor ID + name:</strong> Removes goals matching both criteria.

<strong>Time range + filters:</strong> Removes goals matching the filters within the given window.

Supplying <code>visitorId</code> or <code>name</code> without a time range deletes ALL matching records across the entire history.

Error responses

<strong>400 Bad Request</strong> -- No filter parameters were provided.

<strong>401 Unauthorized</strong> -- API key is missing or invalid.

Delete by name within a date range
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"
Delete all goals for a visitor
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"
    }
  ]
}