Source Plane

One fetched item’s content

{ externalId, item } — the item in the connector seam’s shape (document text, binary as base64, conversation turns, a record envelope), handed to the door for its shape under the connection’s recorder and revision stamp. skipped when the content policy is manifest or the fetch budget is spent. 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}/items

Request

  • Base URL: https://brain.inite.ai
  • URL: https://brain.inite.ai/v1/source-connections/{id}/agent-runs/{runId}/items
  • 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

externalIdstring required

Response

The item’s outcome.

errorstring
status'ingested' | 'deduplicated' | 'failed' | 'skipped' required

Changes

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