Skip to main content
Tool name list_cohorts
Read-only · Idempotent
Browses the cohorts available across one or more workspaces, filtered by type, state, tags, a name keyword, and a user-count range, and ordered by short id, name, or user count. Each returned cohort includes its estimated unique users over the last 30 days. Returns one page at a time.

Example prompt

List all the enabled lookalike cohorts available across my workspaces.

Parameters

cohort_types
enum[]
Restrict to these cohort types. Omit to list all types the caller can see. min 1 item. each one of: custom, lookalike, contextual, standard, classificationModel, advertiser.
max_users
integer (int64)
Only include cohorts with at most this many users. Omit for no upper bound.
min_users
integer (int64)
Only include cohorts with at least this many users. Omit for no lower bound.
name_contains
string
Case-insensitive substring matched against each cohort’s name. Omit to match all cohorts.
page_token
string
Opaque token from a previous response’s next_page_token, to fetch the next page.
sort_by
enum
Field to order the listing by. Defaults to short_id. one of: short_id, name, users.
sort_order
enum
Order direction. Defaults to ascending. one of: asc, desc.
state
enum
Restrict to enabled or disabled cohorts. Omit to list both. one of: enabled, disabled.
tags
string[]
Restrict to cohorts tagged with at least one of these tags. min 1 item.
workspace_ids
string[]
required
Workspaces whose cohorts are aggregated into a single flat list, not broken down by workspace. min 1 item.

Returns

cohorts
CohortListItem[]
A page of cohorts matching the query, in the requested order (short id by default).
incomplete
boolean
required
True when the listing was capped and some matching cohorts are missing (from this page and every other page of this query).
next_page_token
string
Pass as page_token to fetch the next page. Absent on the last page. Expires shortly after the first page.
total_matching
integer (int32)
required
Total cohorts matching the filters across all pages, before pagination.