Skip to content

Skill

A Skill is a capacity a Worker has at a level, such as negotiation or programming, that Roles require.

Properties

PropertyTypeRequiredDescription
levelintegerHow well the Worker performs it.

Object

JSON
{
  "$id": "https://api.sb/shiftnote.app/skills/skill_1",
  "$type": "Skill",
  "level": 1
}

Relationships

  • A Skill is practiced by many Workers: the Skills a Worker has, each at a level, matched against what Roles require. practicedBy, inverse practices.
  • A Skill is required by many Roles: the Skills, each at a level, a Worker needs to fill the Role. requiredBy, inverse requires.

Verbs

  1. createCreates a Skill.
    POST /{namespace}/skillsdoSkill.created
  2. getReturns one Skill by id.
    GET /{namespace}/skills/{id}readNo Event
  3. listReturns Skills, newest first, one page at a time.
    GET /{namespace}/skillsreadNo Event
  4. updateChanges the given properties of a Skill.
    PATCH /{namespace}/skills/{id}doSkill.updated
  5. deleteDeletes a Skill; its history is kept.
    DELETE /{namespace}/skills/{id}doSkill.deleted

Permissions

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

Operationowneradminmemberviewer
Skill.createYesYesYesNo
Skill.getYesYesYesYes
Skill.listYesYesYesYes
Skill.updateYesYesYesNo
Skill.deleteYesYesYesNo

Call it

Text
Add a skill to RouteWise.

Example

The Sales Lead Role requires negotiation at level 3. Sally, the Agent filling it, holds negotiation at level 4.