Skip to content
Streamkap
Esc
↑↓navigate↵open⌘Jpreview

List Agent Config History

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

Response is bounded by the server-side retention window (50 rows per agent by default) and carries a per-row summary.changedFields so the FE sidebar stays cheap - full before/after diffs come from two GET /history/{version} detail reads.

GET/agents/{job_id}/config/history
Authorization
AuthorizationBearer token · headerrequired
Path parameters
job_idstringrequired
Query parameters
limitinteger
default: 20
before_versioninteger
Responses
200

Successful Response

itemsAgentConfigHistoryItem[]
Show properties
Array of AgentConfigHistoryItem
versionintegerrequired
min 0
changedByEmailstring | null

Admin's email in admin-app mode; tenant user's otherwise. None when the row predates author capture (legacy / migrated).

Show properties
Any of:
string
string
null
null
changedTimestampstring<date-time>required
changeKindstringrequired
Allowed:createupdaterollback
rollbackSourceVersioninteger | null

For change_kind='rollback': the version whose config was copied. None otherwise.

Show properties
Any of:
integer
integer
null
null
changeNotestring | null
Show properties
Any of:
string
string
null
null
summaryAgentConfigHistorySummary

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". The FE computes a full before/after diff from two GET /history/{version} detail reads when the user opens a specific version.

Show properties
changedFieldsstring[]

Sorted depth-2 dotted paths that differ from the previous version

totalintegerrequired

Total rows for this agent (bounded by retention)

min 0
nextBeforeVersioninteger | null

Cursor for the next page - pass as ?before_version=…. Null if no more rows.

Show properties
Any of:
integer
integer
null
null
422

Validation Error

detailValidationError[]
Show properties
Array of ValidationError
locstring | integer[]required
Show properties
Array of string | integer
Any of:
string
string
integer
integer
msgstringrequired
typestringrequired
inputany
ctxobject
Request
curl -X GET 'https://api.streamkap.com/agents/string/config/history' \
  -H 'Authorization: Bearer YOUR_TOKEN'
Response
{
  "items": [
    {
      "version": 0,
      "changedByEmail": "string",
      "changedTimestamp": "2019-08-24T14:15:22Z",
      "changeKind": "create",
      "rollbackSourceVersion": 0,
      "changeNote": "string",
      "summary": {
        "changedFields": [
          "string"
        ]
      }
    }
  ],
  "total": 0,
  "nextBeforeVersion": 0
}