Skip to content

Team

A Team is a named group of Roles under one owner; every Startup starts with eleven default Teams.

Read as
GuideSpec

Most stay asleep until their Trigger wakes them.

Properties

PropertyTypeRequiredDescription
missiontextrequiredWhat the Team is for, in one sentence.
statusstringrequiredOne of asleep or awake: whether any of its Processes is on.

Object

JSON
{
  "$id": "https://api.sb/routewise.dev/teams/team_1",
  "$type": "Team",
  "mission": "Example mission",
  "status": "asleep"
}

Relationships

  • A Team groups many Roles: a Team groups the Roles that do one kind of work under one owner. groups, inverse team.
  • A Team serves many Startups: a Team does its one kind of work for every Startup it serves; a Startup wakes a Team when its trigger Event happens. serves, inverse teams.

Lifecycle

Team lifecycle: asleep, awakeasleep → awake: on Process.enabledasleep → awake: on Startup.builtawake → asleep: on Process.pausedasleepawake
StateMeaningMoves to
asleep (first)None of its Processes is on, so its Roles hold no work.awake on Process.enabled when the Process belongs to this Team; awake on Startup.built when the Startup’s Templates turn on one of this Team’s Processes
awakeAt least one of its Processes is on, and its Roles do that work.asleep on Process.paused when no other Process of this Team is on

Verbs

  1. createCreates a Team.
    POST /{namespace}/teamsdoTeam.created
  2. getReturns one Team by id.
    GET /{namespace}/teams/{id}readNo Event
  3. listReturns Teams, newest first, one page at a time.
    GET /{namespace}/teamsreadNo Event
  4. updateChanges the given properties of a Team.
    PATCH /{namespace}/teams/{id}doTeam.updated
  5. deleteDeletes a Team; its history is kept.
    DELETE /{namespace}/teams/{id}doTeam.deleted

Permissions

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

Operationowneradminmemberviewer
Team.createYesYesYesNo
Team.getYesYesYesYes
Team.listYesYesYesYes
Team.updateYesYesYesNo
Team.deleteYesYesYesNo

Call it

Text
Add a team to LedgerLark.

Example

The Customer Team of a tutoring marketplace wakes when the first parent accepts an Offer. It groups the Customer Lead, Onboarding Specialist and Success Manager Roles under one owner.