It’s important to note that all requests to the Cohorts API must be authenticated with a private API key. See the Authentication section for details on obtaining and using a private API key.The behavior of the API depends on which workspace the private API key is associated with in your organization. Details are provided with each endpoint in this documentation.There are various different access levels available. By default, a private API key will provide read-only access to cohorts defined in the workspace that owns the API key, or inherited from workspaces above this workspace in an organization hierarchy. Please contact Technical Services if you would like to discuss different access levels to the Cohorts API.
The behavior of a cohort is defined by a query, which specifies the conditions a user must meet to fall into the cohort. When creating, updating or viewing cohorts, the Cohorts API uses a JSON format to represent these queries.