Skip to content

Resource

A Resource is a Thing whose home is at a Source, such as a Stripe Invoice, with a mode that says which side leads.

Properties

PropertyTypeRequiredDescription
sourceSourcerequiredThe Source it lives at.
modestringrequiredOne of upstream (the Source leads, read through and mirrored), mirrored (copied from a read-only Source) or owned (db.sb leads).
nounNounrequiredThe Noun it is a Thing of, such as Invoice.
mirroredAtdatetimeWhen db.sb last copied it from its Source.

Object

JSON
{
  "$id": "https://api.sb/ratebook.dev/resources/resource_hIVWDprAyZ",
  "$type": "Resource",
  "source": "source_DIdhfB6mF5",
  "mode": "upstream",
  "noun": "noun_iXkcYZtTJh",
  "mirroredAt": "2026-10-22T12:00:00Z"
}

Relationships

Verbs

  1. getReturns one Resource by id.
    GET /{namespace}/resources/{id}readNo Event
  2. listReturns Resources, newest first, one page at a time.
    GET /{namespace}/resourcesreadNo Event

A Resource 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
Resource.getYesYesYesYes
Resource.listYesYesYesYes

Call it

In code: API · SDK · CLI · MCP.

Text
Show me the latest resource.

Works with

WithLinks
TeamsEngineering Team

Example

Stripe leads every Invoice, so each Invoice is an upstream Resource at the Stripe Source. A read goes through to Stripe, and db.sb keeps a mirror that Stripe's webhooks update.