Skip to content

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

PropertyTypeRequiredDescription
queryjsonrequiredThe Portfolio query that selects its Startups.
controlbooleanTrue when the Cohort stays on the prior Version as the control.

Object

JSON
{
  "$id": "https://api.sb/patentpad.com/cohorts/cohort_1",
  "$type": "Cohort",
  "query": {},
  "control": true
}

Relationships

Verbs

  1. createCreates a Cohort.
    POST /{namespace}/cohortsdoCohort.created
  2. getReturns one Cohort by id.
    GET /{namespace}/cohorts/{id}readNo Event
  3. listReturns Cohorts, newest first, one page at a time.
    GET /{namespace}/cohortsreadNo Event
  4. updateChanges the given properties of a Cohort.
    PATCH /{namespace}/cohorts/{id}doCohort.updated
  5. deleteDeletes a Cohort; its history is kept.
    DELETE /{namespace}/cohorts/{id}doCohort.deleted

Permissions

Which Access level may call each Verb. One-way Verbs wait their delay window.

Operationowneradminmemberviewer
Cohort.createYesYesYesNo
Cohort.getYesYesYesYes
Cohort.listYesYesYesYes
Cohort.updateYesYesYesNo
Cohort.deleteYesYesYesNo

Call it

Text
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.