Skip to main content
POST
Run, Enable, Disable & Items

Draft — needs review

Auth: Authorization: Bearer tr_...

POST /v0/sources/{id}/run

Schedules the source to run on the next runner tick — it does not run synchronously. The runner ticks every minute.

POST /v0/sources/{id}/enable

Re-enables a disabled source, clears its failure counter and last error, and schedules an immediate run.

POST /v0/sources/{id}/disable

Stops the source polling. Idempotent — disabling an already-disabled source leaves it alone.
Sources also disable themselves. Twenty consecutive failures auto-disables one and emails its creator; so does losing a brain a fathom source needs, or the creator leaving the team the source belongs to.

GET /v0/sources/{id}/items

The item ledger — what the source discovered and what each item produced.

Item states

The ledger is what makes re-running safe: it dedupes by the upstream’s own id, so a repeated poll re-discovers rather than double-landing.

Error codes

Operator mirror

POST /v0/operator/sources/{id}/{run,enable,disable} and GET /v0/operator/sources/{id}/items.