> ## Documentation Index
> Fetch the complete documentation index at: https://developers.redo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# segmentsDelete

> Delete several segments at once, with their snapshots; a static segment's members lose that membership. This cannot be undone. Returns the passed ids that matched one of the store's segments and were deleted; other ids are skipped. Fails with CANNOT_DELETE_PROTECTED_SEGMENT, deleting nothing, if the list holds the Texas SMS exclusion segment. If the call fails partway, some segments may already be deleted; repeating it is safe.

**Required scopes:** [`segments_write`](https://developers.redo.com/docs/api-reference/v3/reference/scopes#scope-segments_write)

**Store must have one of:** `EMAIL_SMS`

## Arguments

**ids** `[ID!]!` *required*

The `id` (or `legacyId`) of each segment to delete, 1 to 100.

## Returns

**segmentsDelete** `[ID!]!` *required*

## Example

```graphql theme={null}
mutation {
  segmentsDelete(ids: "...")
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.