Skip to content

Capability

A Capability is a named set of Verbs on one Noun family that every Startup reaches through api.sb with one key, metered, limited, and logged.

Properties

PropertyTypeRequiredDescription
namestringrequiredThe name, such as Workflows or Search.
nounslist of NounrequiredThe Nouns it exposes, each with its Verbs.
modesjsonThe Mode each Verb accepts; a stateless Verb is try only.
upstreamstringWho performs it behind api.sb, held as data and swappable without a caller noticing.

Object

JSON
{
  "$id": "https://api.sb/quietcopy.com/capabilities/capability_1",
  "$type": "Capability",
  "name": "QuietCopy",
  "nouns": [
    "noun_1"
  ],
  "modes": {},
  "upstream": "Example upstream"
}

Relationships

Verbs

  1. getReturns one Capability by id.
    GET /{namespace}/capabilities/{id}readNo Event
  2. listReturns Capabilities, newest first, one page at a time.
    GET /{namespace}/capabilitiesreadNo Event

A Capability is kept forever and never edited: it has no update or delete.

Permissions

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

Operationowneradminmemberviewer
Capability.getYesYesYesYes
Capability.listYesYesYesYes

Call it

Text
Show me the latest capability.

Example

A clinic-reminder SaaS sends 9,000 text reminders a day through the messaging Capability. It uses the key it uses for payments and search, every send is metered, and its Limit stops sends past 12,000 a day.