Docs: Tool reference
customers toolset

delete_segment

Delete a segment. Deletes a segment definition. Its users aren't touched. Saved filters that name it stop matching. Nobody is emailed. Managers and owners.

Toolset
customers
Who can call it
OwnersManagersAPI keys
REST
DELETE /api/v1/w/{workspace}/segments/{segment}
Behavior
changes data

Input

FieldTypeDescription
segmentrequiredstringThe segment's ID (seg_…) or name.

Output

FieldTypeDescription
idrequiredstring
namerequiredstring

Calling it

// MCP: tools/call
{ "name": "delete_segment", "arguments": {"segment":"<string>"} }

// Typed client
await carechannel.delete_segment({"segment":"<string>"});