# segments

> Dynamic (rule) and static (list) segments.

Dynamic (rule) and static (list) segments.

| Method | Path | Operation | Scope | Test mode |
|---|---|---|---|---|
| GET | `/v1/segments` | `segments_list`: List segments | `contacts:read` | - |
| POST | `/v1/segments` | `segments_create`: Create a dynamic (rule) or static (list) segment | `contacts:write` | - |
| POST | `/v1/segments:preview` | `segments_preview`: Preview rule count, a sample and the estimated Meta cost | `contacts:read` | - |
| DELETE | `/v1/segments/{segment_id}` | `segments_delete`: Delete a segment (contacts are not touched) | `contacts:write` | - |
| GET | `/v1/segments/{segment_id}` | `segments_get`: Get a segment with its current member count | `contacts:read` | - |
| PATCH | `/v1/segments/{segment_id}` | `segments_update`: Rename a segment or replace its rules | `contacts:write` | - |
| GET | `/v1/segments/{segment_id}/contacts` | `segments_list_contacts`: Contacts in a segment | `contacts:read` | - |
| POST | `/v1/segments/{segment_id}/members` | `segments_add_members`: Add contacts to a static segment | `contacts:write` | - |
| DELETE | `/v1/segments/{segment_id}/members/{contact_id}` | `segments_remove_member`: Remove a contact from a static segment | `contacts:write` | - |

Request and response schemas: the interactive reference at `https://api.wapitick.com/docs`, or `docs/api/openapi.json`.
