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
| Property | Type | Required | Description |
|---|---|---|---|
source | Source | required | The Source it lives at. |
mode | string | required | One of upstream (the Source leads, read through and mirrored), mirrored (copied from a read-only Source) or owned (db.sb leads). |
noun | Noun | required | The Noun it is a Thing of, such as Invoice. |
mirroredAt | datetime | When db.sb last copied it from its Source. |
Object
{
"$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
- A Resource has many Datasets: a Dataset is built from Resources at its Sources, plus enrichment.
datasets, inversebuiltFrom. - A Resource lives at one Source: each Resource lives at one Source, and a Source holds many Resources.
livesAt, inverseresources.
Verbs
getReturns one Resource by id.GET /{namespace}/resources/{id}listReturns Resources, newest first, one page at a time.GET /{namespace}/resources
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.
| Operation | owner | admin | member | viewer |
|---|---|---|---|---|
Resource.get | Yes | Yes | Yes | Yes |
Resource.list | Yes | Yes | Yes | Yes |
Call it
In code: API · SDK · CLI · MCP.
Show me the latest resource.Works with
| With | Links |
|---|---|
| Teams | Engineering 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.