API Reference

Delete Goals

Name: Flowsery
Author: Flowsery

Remove goal events by visitor, name, or time range

DELETEhttps://analytics.flowsery.com/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

Parameter	Type	Description
`visitorId`	`string`	Remove goals tied to a specific visitor ID.
`name`	`string`	Remove goals matching a specific event name (e.g., signup, purchase).
`startAt`	`string`	ISO 8601 start timestamp (e.g., 2024-01-01T00:00:00Z).
`endAt`	`string`	ISO 8601 end timestamp (e.g., 2024-01-31T23:59:59Z).

Deletion behavior

Time range only: Removes every goal within that period.

Visitor ID only: Removes all goals for that visitor (all time).

Name only: Removes all goals with that name (all time).

Visitor ID + name: Removes goals matching both criteria.

Time range + filters: 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

400 Bad Request -- No filter parameters were provided.

401 Unauthorized -- 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"
    }
  ]
}