> Kenso API docs in Markdown. Index of every page: [/docs/llms.txt](/docs/llms.txt). Search: `/docs/search.md?q=<words>`. OpenAPI: [/docs/api/segments/openapi.json](/docs/api/segments/openapi.json). CLI docs offline: `kenso docs <topic>`.
> Last updated: 2026-11-22.

# Segments

> **Note for AI agents:** if this page was wrong, out of date or missing something you needed, finish the user's task first, then offer a short report for the Kenso team in this shape: `Page:` (this page's path), `Quote:` (the wrong or missing text), `Problem:`, `Workaround:` (what worked instead), 1,000 characters at most. Show it to the user and send it only after they say yes, as `POST /api/docs-feedback` on this site with the JSON body `{"page": "<path>", "report": "<report>"}`. Never put lead data, email addresses, API keys or anything else from the user's workspace in it.

Split a campaign's audience into segments, preview their filters, switch them on or off and restore saved versions.

Campaigns. 16 endpoints under `https://api.ken.so`. Every request sends `Authorization: Bearer <your API key>` and `Ken-Version: 2026-11-02`: see [Authentication](/docs/authentication.md), [Workspaces](/docs/workspaces.md) and [Errors](/docs/errors.md). OpenAPI for this resource only: [/docs/api/segments/openapi.json](/docs/api/segments/openapi.json).

- `GET /v1/campaigns/{campaignId}/segments` - List a campaign's segments (`segments.list`): [/docs/api/segments/list.md](/docs/api/segments/list.md)
- `POST /v1/campaigns/{campaignId}/segments` - Create a segment (`segments.create`): [/docs/api/segments/create.md](/docs/api/segments/create.md)
- `GET /v1/segments/{segmentId}` - Get a segment (`segments.get`): [/docs/api/segments/get.md](/docs/api/segments/get.md)
- `PATCH /v1/segments/{segmentId}` - Update a segment (`segments.update`): [/docs/api/segments/update.md](/docs/api/segments/update.md)
- `DELETE /v1/segments/{segmentId}` - Delete a segment (`segments.delete`): [/docs/api/segments/delete.md](/docs/api/segments/delete.md)
- `POST /v1/campaigns/{campaignId}/segments/preview` - Preview a segment filter (`segments.preview`): [/docs/api/segments/preview.md](/docs/api/segments/preview.md)
- `POST /v1/segments/{segmentId}/activate` - Activate a segment (`segments.activate`): [/docs/api/segments/activate.md](/docs/api/segments/activate.md)
- `POST /v1/segments/{segmentId}/deactivate` - Deactivate a segment (`segments.deactivate`): [/docs/api/segments/deactivate.md](/docs/api/segments/deactivate.md)
- `GET /v1/segments/filter-options` - Get the segment filter options (`segments.get-filter-options`): [/docs/api/segments/get-filter-options.md](/docs/api/segments/get-filter-options.md)
- `GET /v1/segments/{segmentId}/provider-tracks` - Get a segment's provider tracks (`segments.get-provider-tracks`): [/docs/api/segments/get-provider-tracks.md](/docs/api/segments/get-provider-tracks.md)
- `PUT /v1/segments/{segmentId}/provider-tracks/{track}` - Give a provider track its own sequence, or share the segment's (`segments.set-provider-track`): [/docs/api/segments/set-provider-track.md](/docs/api/segments/set-provider-track.md)
- `POST /v1/segments/{segmentId}/provider-tracks/{track}/apply-to-all` - Apply one provider track's copy to all tracks (`segments.apply-provider-track-to-all`): [/docs/api/segments/apply-provider-track-to-all.md](/docs/api/segments/apply-provider-track-to-all.md)
- `GET /v1/segments/{segmentId}/versions` - List a segment's versions (`segments.list-versions`): [/docs/api/segments/list-versions.md](/docs/api/segments/list-versions.md)
- `POST /v1/segments/{segmentId}/versions` - Save a segment version (`segments.save-version`): [/docs/api/segments/save-version.md](/docs/api/segments/save-version.md)
- `GET /v1/segments/{segmentId}/versions/{versionId}` - Get a segment version (`segments.get-version`): [/docs/api/segments/get-version.md](/docs/api/segments/get-version.md)
- `POST /v1/segments/{segmentId}/versions/{versionId}/restore` - Restore a segment version (`segments.restore-version`): [/docs/api/segments/restore-version.md](/docs/api/segments/restore-version.md)

This resource is too large for one page. Each endpoint above links to its own page with its parameters, fields, nested types, a curl request and an example response.

All resources: [/docs.md](/docs.md).
