Skip to content
ProductCraft
DocsPricingChangelog
Sign inOpen the console
Console

Available now

  • AuthSign-in, organizations and roles
  • MailTransactional email on your domain
  • WaitlistWaitlists without the spreadsheet
  • SocialFeeds, follows, ranking
  • TrawlTurn web pages into JSON
  • FlagsFeature flags evaluated in your app
  • NotifyInbox, email and push in one call
PLATFORMSeven products, one workspaceOne account and one API key for all seven.See the lineup→
ProductCraft

Available now

  • AuthSign-in, organizations and roles
  • MailTransactional email on your domain
  • WaitlistWaitlists without the spreadsheet
  • SocialFeeds, follows, ranking
  • TrawlTurn web pages into JSON
  • FlagsFeature flags evaluated in your app
  • NotifyInbox, email and push in one call
  • Docs
  • Pricing
  • Changelog
Sign in
← Mail API reference

Mail API · Segments

delete/v1/workspaces/{workspace_id}/segments/{segment_id}Auth

Delete a segment

Contacts are not touched; a static segment's member list goes with it.

Path parameters

workspace_id*string · uuid

Id of the workspace.

segment_id*string · uuid

Id of the segment.

Response · 204

Deleted.

Example

Request

DELETE https://api.mail.productcraft.co/v1/workspaces/{workspace_id}/segments/{segment_id}
Authorization: Bearer YOUR_TOKEN

More in Segments

  • get/v1/workspaces/{workspace_id}/contacts/{contact}/segmentsList a contact's segments
  • post/v1/workspaces/{workspace_id}/contacts/{contact}/segments/{segment_id}Add a contact to a static segment
  • delete/v1/workspaces/{workspace_id}/contacts/{contact}/segments/{segment_id}Remove a contact from a static segment
  • get/v1/workspaces/{workspace_id}/segmentsList segments, newest first
  • post/v1/workspaces/{workspace_id}/segmentsCreate a segment
  • post/v1/workspaces/{workspace_id}/segments/previewPreview a segment rule
  • get/v1/workspaces/{workspace_id}/segments/{segment_id}Get a segment
  • patch/v1/workspaces/{workspace_id}/segments/{segment_id}Update a segment
  • delete/v1/workspaces/{workspace_id}/segments/{segment_id}Delete a segment
  • get/v1/workspaces/{workspace_id}/segments/{segment_id}/contactsList a segment's contacts
  • get/v1/workspaces/{workspace_id}/segments/{segment_id}/metricsA segment's size and unsubscribed share
← Update a segmentList a segment's contacts →
ProductCraft

Backend building blocks for you and your AI agents.

Products

  • Auth
  • Mail
  • Waitlist
  • Social
  • Trawl
  • Flags
  • Notify

Developers

  • Documentation
  • Auth docs
  • Mail docs
  • Waitlist docs
  • Social docs
  • Trawl docs
  • Flags docs
  • Notify docs
  • SDKs
  • MCP

Resources

  • npm
  • GitHub
  • Changelog
  • Status
  • Roadmap

Company

  • Pricing
  • Contact

Legal

  • Privacy
  • Terms

© 2026 ProductCraft. All rights reserved.

Made for builders. hello@productcraft.co