Cohort
A Cohort is a set of Startups that receives one Version of a shared definition, or one step of a Play, at the same time.
Properties
| Property | Type | Required | Description |
|---|---|---|---|
query | json | required | The Portfolio query that selects its Startups. |
control | boolean | True when the Cohort stays on the prior Version as the control. |
Object
{
"$id": "https: //api.sb/ patentpad.com/ cohorts/ cohort_1",
"$type": "Cohort",
"query": {},
"control": true
}Relationships
- A Cohort is drawn from one Portfolio: a Cohort selects its Startups from one Portfolio by a saved query.
drawnFrom, inversecohorts. - A Cohort is pinned to one Version: every Startup in a Cohort runs the same Version of a shared definition; a control Cohort keeps the prior one.
pinnedTo, inversepinnedCohorts.
Verbs
createCreates a Cohort.POST /{namespace}/cohortsgetReturns one Cohort by id.GET /{namespace}/cohorts/{id}listReturns Cohorts, newest first, one page at a time.GET /{namespace}/cohortsupdateChanges the given properties of a Cohort.PATCH /{namespace}/cohorts/{id}deleteDeletes a Cohort; its history is kept.DELETE /{namespace}/cohorts/{id}
Permissions
Which Access level may call each Verb. One-way Verbs wait their delay window.
| Operation | owner | admin | member | viewer |
|---|---|---|---|---|
Cohort.create | Yes | Yes | Yes | No |
Cohort.get | Yes | Yes | Yes | Yes |
Cohort.list | Yes | Yes | Yes | Yes |
Cohort.update | Yes | Yes | Yes | No |
Cohort.delete | Yes | Yes | Yes | No |
Call it
Add a cohort to ShiftNote.Example
A Studio rolls Keyless signup out to a first Cohort: 1% of its Startups with a priced API. A control Cohort of the same size stays on the prior Version.