# REST: segments

Source: <https://telegafirst.com/docs/api-segments>
Locale: ru
releaseGitSha: 0bb11ef116e17ec64c802d5476eaff442e53d252
sourceContentDigest: 44b3300d60fb2ee017f405b939671fa95906ae0f9d782624d27069874aa84306
Version: 9

# REST: segments

Выберите операцию: полный контракт доступен по ссылке. Scopes: ALL; auth alternatives: OR.

## describeSegmentAxes

`GET /api/v1/tools/segments/axes` — Describe the broadcast audience taxonomy

Scopes (ALL): \["broadcasts:read"]. Auth (OR): \[{"hubApiKey":\[]},{"hubBearer":\[]}].

[Параметры, ответы и права](https://telegafirst.com/docs/api-op-describesegmentaxes)

## previewSegmentReach

`POST /api/v1/tools/segments/reach` — Preview audience reach without sending

Scopes (ALL): \["broadcasts:read"]. Auth (OR): \[{"hubApiKey":\[]},{"hubBearer":\[]}].

[Параметры, ответы и права](https://telegafirst.com/docs/api-op-previewsegmentreach)

## sampleSegmentAudience

`POST /api/v1/tools/segments/sample` — Sample a valid audience by tenant user sequence

Scopes (ALL): \["dialogs:read"]. Auth (OR): \[{"hubApiKey":\[]},{"hubBearer":\[]}].

[Параметры, ответы и права](https://telegafirst.com/docs/api-op-samplesegmentaudience)

## listSavedSegments

`GET /api/v1/tools/segments/saved` — List saved audience filters

Scopes (ALL): \["broadcasts:read"]. Auth (OR): \[{"hubApiKey":\[]},{"hubBearer":\[]}].

[Параметры, ответы и права](https://telegafirst.com/docs/api-op-listsavedsegments)

## createSavedSegment

`POST /api/v1/tools/segments/saved` — Create a saved audience filter

Scopes (ALL): \["broadcasts:write"]. Auth (OR): \[{"hubApiKey":\[]},{"hubBearer":\[]}].

[Параметры, ответы и права](https://telegafirst.com/docs/api-op-createsavedsegment)

## deleteSavedSegment

`DELETE /api/v1/tools/segments/saved/{seqNum}` — Delete an unreferenced saved filter with optimistic version

Scopes (ALL): \["broadcasts:write"]. Auth (OR): \[{"hubApiKey":\[]},{"hubBearer":\[]}].

[Параметры, ответы и права](https://telegafirst.com/docs/api-op-deletesavedsegment)

## getSavedSegment

`GET /api/v1/tools/segments/saved/{seqNum}` — Read a saved audience filter

Scopes (ALL): \["broadcasts:read"]. Auth (OR): \[{"hubApiKey":\[]},{"hubBearer":\[]}].

[Параметры, ответы и права](https://telegafirst.com/docs/api-op-getsavedsegment)

## updateSavedSegment

`PATCH /api/v1/tools/segments/saved/{seqNum}` — Update a saved filter with optimistic version

Scopes (ALL): \["broadcasts:write"]. Auth (OR): \[{"hubApiKey":\[]},{"hubBearer":\[]}].

[Параметры, ответы и права](https://telegafirst.com/docs/api-op-updatesavedsegment)

## listSegmentTargets

`POST /api/v1/tools/segments/targets` — List a segmentation kind’s targets

Scopes (ALL): \["broadcasts:read"]. Auth (OR): \[{"hubApiKey":\[]},{"hubBearer":\[]}].

[Параметры, ответы и права](https://telegafirst.com/docs/api-op-listsegmenttargets)