Delete a segment
DELETE
/segments/{id}Authorization
AuthorizationBearer token · headerrequiredA BillionSend API key (bs_…).
Path parameters
idstring<uuid>requiredResponses
200
Segment deleted
objectstringrequiredAllowed:
segmentidstring<uuid>requireddeletedbooleanrequiredAllowed:
true401
Missing, malformed, unknown or revoked API key
statusCodenumberrequirednamestringrequiredmessagestringrequired404
Not found
statusCodenumberrequirednamestringrequiredmessagestringrequired409
Segment is in use
statusCodenumberrequirednamestringrequiredmessagestringrequired429
Over the rate limit (rate_limit_exceeded, with Retry-After)
statusCodenumberrequirednamestringrequiredmessagestringrequired