Source Plane

Begin an agent run

Opens one run (a source_sync job_run, actor agent:<id>) and answers with whether the walk must be full (first run, or requested), the checkpoint to resume from, the content policy and the fetch budget. One running agent run per connection — a second begin is 409. 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

Request

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

Path parameters

idstring required

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

Request body

agentIdstring required
fullboolean

Response

The run.

checkpointobject nullable required
contentPolicy'manifest' | 'text' | 'bytes' required
fetchBudgetinteger nullable required
fullboolean required
runIdstring required

Changes

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