Source Plane

A batch of catalogue deltas

Up to 1000 upsert / gone / checkpoint deltas from the agent’s walk, applied to the catalogue exactly as a server walk would be. The answer names the items whose revision moved — the ones the agent must now fetch and post. The local agent’s wire (docs/source-plane.md § Agent): the connector runs on the agent’s machine, the engine keeps the books here. Scope brain:write — a tenant write key, never an admin one; it reaches only the connections an operator pointed at its host (host: agent:<id>). Source plane operator surface (docs/roadmap/raw-evidence-sources-2026-09.md) — answers a bare 404 until SOURCE_PLANE_ENABLED=1.

Required scope: brain:write.

post/v1/source-connections/{id}/agent-runs/{runId}/deltas

Request

  • Base URL: https://brain.inite.ai
  • URL: https://brain.inite.ai/v1/source-connections/{id}/agent-runs/{runId}/deltas
  • Auth: HTTP bearer

Path parameters

idstring required

Connection id (source_connection:<tail>; the bare tail is accepted).

runIdstring required

The run id begin returned (a source_sync job_run).

Request body

Response

What to fetch, and the batch’s counters.

changedinteger required
fetchstring[] required
goneinteger required
newinteger required
seeninteger required
unchangedinteger required

Changes

No recorded changes to this operation across all 1 revision of this API.