Документация / Как начать / Работа с MCP / Идентификаторы и страницы результатов / REST: segments / listSavedSegments Для AI-агентов: markdown этой страницы — /docs/api-op-listsavedsegments.md · индекс документации — /llms.txt
listSavedSegments Обновлено 4 октября 2026 г.
GET /api/v1/tools/segments/saved
List saved audience filters
# Авторизация и праваScopes: ALL. Auth alternatives: OR; scopes внутри альтернативы: ALL.
Поле Значение security.0.hubApiKey [] security.1.hubBearer [] securitySchemes.hubApiKey.in "header" securitySchemes.hubApiKey.name "X-Api-Key" securitySchemes.hubApiKey.type "apiKey" securitySchemes.hubBearer.scheme "bearer" securitySchemes.hubBearer.type "http" x-required-scopes ["broadcasts:read"]
# Параметры запросаПоле Значение 0.in "query" 0.name "afterSeqNum" 0.required false 0.schema 0.schema 1.in "query" 1.name "limit" 1.required false 1.schema 1.schema
# Тело запросаПоле Значение Тело запроса null
# Ответы# ОшибкиПоле Значение 400.content.application/problem+json.schema ProblemDetails 400.description "Strict query validation failed." 400.x-error-codes ["VALIDATION_ERROR"] 401.content.application/problem+json.schema ProblemDetails 401.description "Missing, invalid, revoked, expired or conflicting API credentials; surface-session JWT is not accepted." 401.x-error-codes ["INVALID_API_KEY"] 403.content.application/problem+json.schema ProblemDetails 403.description "Required effective scope, non-publishable credential and an active bot are mandatory." 403.x-error-codes ["INSUFFICIENT_SCOPE","PUBLISHABLE_KEY_NOT_ALLOWED","NO_ACTIVE_BOT"] 413.content.application/problem+json.schema ProblemDetails 413.description "The per-tool request size or item count exceeds the resource policy." 413.x-error-codes ["PAYLOAD_TOO_LARGE","ITEM_COUNT_EXCEEDED"] 429.content.application/problem+json.schema ProblemDetails 429.description "The per-tool rate limit is exceeded or unavailable; fail closed." 429.headers.Retry-After.description "Seconds before retry, when supplied by the resource policy." 429.headers.Retry-After.required false 429.headers.Retry-After.schema 429.headers.Retry-After.schema 429.x-error-codes ["RATE_LIMIT_EXCEEDED","RATE_LIMIT_UNAVAILABLE"] 500.content.application/problem+json.schema ProblemDetails 500.description "Unexpected failure; the private cause is withheld." 500.x-error-codes ["INTERNAL_ERROR"]
# Дополнительные условияПоле Значение description "Ascending tenant sequence keyset: afterSeqNum is exclusive and nonnegative, limit defaults to 100 (max500). nextAfterSeqNum is the last returned sequence when another page exists, otherwise null." operationId "listSavedSegments" summary "List saved audience filters" tags ["segments"] x-idempotency.kind "none" x-pagination.after "afterSeqNum" x-pagination.kind "sequence" x-pagination.limit 100 x-pagination.maximum 500 x-pagination.next "nextAfterSeqNum"