---
title: "List Agent Config History"
method: GET
path: "/agents/{job_id}/config/history"
tags: ["Agents"]
---

# List Agent Config History

`GET /agents/{job_id}/config/history`

## Request

- Base URL: `https://api.streamkap.com`
- URL: `https://api.streamkap.com/agents/{job_id}/config/history`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/streamkap/apis/streamkap-rest-api/docs/agents/:job_id/config/history/get.ts> (a function with typed inputs; its response is checked against the schema)

List a config-based agent's config-change history, newest first.

Response is bounded by the server-side retention window (50 entries per
agent by default). Each entry carries ``summary.changedFields`` instead of
the full config; for a full before/after diff, fetch both versions with
``GET /agents/{job_id}/config/history/{version}``.

## Path parameters

- `job_id` string, required

## Query parameters

- `limit` integer
- `before_version` integer, nullable

## Response `200`

Successful Response

- AgentConfigHistoryListResponse: Response for ``GET /agents/{id}/config/history``.
  - `items` AgentConfigHistoryItem[]
    - `version` integer, required
    - `changedByEmail` string, nullable: Admin's email in admin-app mode; tenant user's otherwise. ``None`` when the row predates author capture (legacy / migrated).
    - `changedTimestamp` string, date-time, required
    - `changeKind` 'create' | 'update' | 'rollback', required
    - `rollbackSourceVersion` integer, nullable: For change_kind='rollback': the version whose config was copied. None otherwise.
    - `changeNote` string, nullable
    - `summary` AgentConfigHistorySummary: Cheap diff preview stored on every history row at write time. The list endpoint returns this without shipping the full config blobs. ``changedFields`` is a sorted list of dotted paths at depth ≤ 2 (e.g. ``["prompts.customInstructions", "tools"]``). A deeper change inside ``tools[].config.headers`` collapses to ``"tools"``. For a full before/after diff, fetch both versions with ``GET /agents/{job_id}/config/history/{version}``.
      - `changedFields` string[]: Sorted depth-2 dotted paths that differ from the previous version
  - `total` integer, required: Total rows for this agent (bounded by retention)
  - `nextBeforeVersion` integer, nullable: Cursor for the next page - pass as ``?before_version=…``. Null if no more rows.

## Other responses

- `422`: Validation Error

## Changes

- **2026-08-04** `2a3df099f4a9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/streamkap/apis/streamkap-rest-api/changes/agents/:job_id/config/history/get.md)

---

[API](https://skmtc.dev/streamkap/apis/streamkap-rest-api.md) - [All operations](https://skmtc.dev/streamkap/apis/streamkap-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/streamkap/apis/streamkap-rest-api/revisions/56dda39bb53c?raw)