---
title: "Read source-backed changes against immutable prior results"
method: GET
path: "/v1/workspace/collections/{collection_id}/changes"
---

# Read source-backed changes against immutable prior results

`GET /v1/workspace/collections/{collection_id}/changes`

## Request

- Base URL: `https://api.specstream.ai`
- URL: `https://api.specstream.ai/v1/workspace/collections/{collection_id}/changes`
- Auth: API key in header `Authorization`

## Path parameters

- `collection_id` string, required

## Response `200`

Read source-backed changes against immutable prior results

- object
  - `data` WorkspaceCollectionChanges, required
    - `collectionId` string, required
    - `checkedAt` string, nullable
    - `runId` string, nullable
    - `monitorId` string, nullable
    - `status` 'changed' | 'unchanged' | 'unresolved' | 'unavailable' | 'not_checked', required
    - `changes` WorkspaceRecordChange[]
      - `recordId` string, required
      - `field` string, required
      - `label` string, required
      - `before` string, required
      - `after` string, required
      - `source` string, nullable
      - `url` string, nullable
      - `currentRecordId` string, nullable
      - `sourceCollectionId` string, nullable
      - `sourceRecordId` string, nullable
    - `comparisons` WorkspaceFieldComparison[]
      - `recordId` string, required
      - `field` string, required
      - `label` string, required
      - `status` 'changed' | 'added' | 'unchanged' | 'unresolved' | 'unavailable', required
      - `before` unknown
      - `after` unknown
      - `source` string, nullable
      - `url` string, nullable
      - `sourceCollectionId` string, nullable
      - `sourceRecordId` string, nullable
    - `records` object[]
    - `summary` object
    - `parentSnapshotId` string, nullable
    - `checks` object[]

## Other responses

- `default`: Error envelope

---

[API](https://skmtc.dev/specstream/apis/specstream-api.md) · [All operations](https://skmtc.dev/specstream/apis/specstream-api/llms.txt) · [OpenAPI document](https://skmtc.dev/specstream/apis/specstream-api/revisions/5a9f51143a13?raw)