Sign in

v1

latestOpenAPI 3.0.02026-07-13103151174.7 KB
Audiences

List Audiences

List Audiences

get/v1/projects/{project}/audiences

Path parameters

projectstring required

A Project key or ID

Query parameters

pagenumber
perPagenumber
sortBy'createdAt' | 'updatedAt' | 'name' | 'key' | 'propertyKey'
sortOrder'asc' | 'desc'
searchstring
createdBystring
includeUsageboolean

Response

namestring

Audience display name, must be set for project-level audiences.

keystring

Audience unique project-level key, must be set for project-level audiences. Must only contain lower-case characters and _, - or ..

descriptionstring

Audience description.

_idstring required

A unique Audience ID

_projectstring required

The Project owning the Audience

source'api' | 'dashboard' | 'importer' | 'github.code_usages' | 'github.pr_insights' | 'gitlab.code_usages' | 'gitlab.pr_insights' | 'bitbucket.code_usages' | 'bitbucket.pr_insights' | 'terraform' | 'cli' | 'slack' | 'mcp'

Source that created the Audience

_createdBystring

User who created the Audience

createdAtstring date-time required

The date the feature was created

updatedAtstring date-time required

The date the feature was last updated

tagsstring[]

Tags to organize project-level audiences on the dashboard

readonlyboolean required

Readonly state based on the Users Permission to modify the Audience

hasUsageboolean

Whether the audience is in use by a feature

Example response

[
  {
    "name": "Android Users",
    "key": "android-users",
    "description": "Users with android devices",
    "_id": "61450f3daec96f5cf4a49946",
    "_project": "61450f3daec96f5cf4a49955",
    "filters": {
      "filters": [
        {
          "subType": "email",
          "comparator": "!=",
          "values": [
            "baduser@email.com"
          ],
          "type": "user"
        }
      ]
    },
    "readonly": true,
    "hasUsage": true
  }
]