Skip to main content
DELETE
Delete a view

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

idempotency-key
string

Any client-chosen key, a uuid for example. Sending the same request twice with the same key has one effect and returns the same response twice; the same key with a different body returns 409.

Required string length: 1 - 255
Example:

"3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d"

Path Parameters

id
string
required

The view to delete, by name or id from list_views. A People view and a Companies view can share a name; then add the subject, as in "Your audience (companies)".

Required string length: 1 - 200

Query Parameters

confirm_id
string

The confirm_id of a needs_confirmation answer: commits what that answer summarised.

Response

The result, or without confirm_id first a needs_confirmation answer: nothing happened yet.

deleted
boolean
required
already_deleted
boolean
required

True when the view was gone already; nothing was done.

stopped_syncs
integer
required

How many active syncs stopped.

app_url
string
required