v1

latestOpenAPI 3.0.02026-07-2484509641.9 KB
Audiences

List Folders

Retrieves a paginated list of all folders, with optional filtering and sorting. Use this endpoint to browse the folder structure or to find a folderId before creating or moving an audience. Filter by createdById, updatedById, searchText (partial name match), or date ranges (createdAfter, createdBefore, updatedAfter, updatedBefore). Use sort to order results by name, createdAt, updatedAt, audienceCount, or recentlyViewed; prefix with - for descending order (default: -updatedAt). Use page[number] and page[size] (default 25, max 100) to paginate. Returns 200 with a paginated array of folder resources including audiences (list of audience IDs in each folder) and navigation links. Returns 400 if filter or sort parameters are invalid.

get/studio/v1/folders

Query parameters

page[number]integer

Page number for the results.

page[size]integer

Number of records to return per page. Default is 25.

sortstring

Field based on which to sort the results. Use '-' prefix for descending order. Allowed values: name, createdAt, updatedAt, audienceCount, recentlyViewed

filter[createdById]integer[]

Filter folders by userId of the creator.

filter[updatedById]integer[]

Filter folders by userId of the last updated person.

filter[searchText]string

Search folders by name (partial match).

filter[createdAfter]string date-time

Filter folders created after a specific date. Eg: 2025-10-10T17:08:00Z

filter[createdBefore]string date-time

Filter folders created before a specific date. Eg: 2025-10-10T17:08:00Z

filter[updatedAfter]string date-time

Filter folders updated after a specific date. Eg: 2025-10-10T17:08:00Z

filter[updatedBefore]string date-time

Filter folders updated before a specific date. Eg: 2025-10-10T17:08:00Z

Response

Success