---
title: "The connection’s runs"
method: GET
path: "/v1/admin/source-connections/{id}/runs"
tags: ["Source Plane"]
---

# The connection’s runs

`GET /v1/admin/source-connections/{id}/runs`

## Request

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

Every sync of the connection, newest first — queued, inline and agent runs alike, each a `source_sync` job_run projected to who ran it, its mode, counters, duration and error. `persisted: false` when JOB_RUN_PERSIST is off. Source plane operator surface (docs/roadmap/raw-evidence-sources-2026-09.md) — answers a bare 404 until `SOURCE_PLANE_ENABLED=1`.

Required scope: `brain:admin`.

## Path parameters

- `id` string, required

## Query parameters

- `limit` integer

## Response `200`

The runs.

- SourceRunsResponse
  - `connectionId` string, required
  - `persisted` boolean, required
  - `runs` object[], required
    - `counters` object, nullable, required
      - `changed` integer, required
      - `closed` integer, required
      - `deduplicated` integer, required
      - `failed` integer, required
      - `fetched` integer, required
      - `gone` integer, required
      - `ingested` integer, required
      - `new` integer, required
      - `seen` integer, required
      - `unchanged` integer, required
    - `durationMs` integer, nullable, required
    - `error` string, nullable, required
    - `finishedAt` string, nullable, required
    - `mode` 'full' | 'incremental' | 'webhook', nullable, required
    - `ranBy` string, required
    - `runId` string, required
    - `skipped` string, nullable, required
    - `startedAt` string, required
    - `status` 'running' | 'succeeded' | 'failed' | 'cancelled' | 'pending', required
    - `triggeredBy` 'cron' | 'manual' | 'startup', required

## Other responses

- `400`: Validation failed.
- `401`: Missing or unknown bearer key.
- `403`: The key lacks the required scope.
- `404`: No such resource in this tenant.

---

[API](https://skmtc.dev/inite/apis/inite-brain-platform-api.md) · [All operations](https://skmtc.dev/inite/apis/inite-brain-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/inite/apis/inite-brain-platform-api/revisions/c7c3eb5e304b?raw)