---
title: "Execute Incremental Snapshot"
method: POST
path: "/sources/execute_incremental_snapshot"
tags: ["Sources"]
---

# Execute Incremental Snapshot

`POST /sources/execute_incremental_snapshot`

## Request body

- ExecuteSnapshotBody — Execute Snapshot Body
  - `source_id` string, required
  - `topic_names` string[], nullable
  - `additional_conditions` AdditionalCondition[], nullable
    - `data_collection` string, required — The data collection (e.g., table or collection name) to apply the filter to.
    - `filter` string, required — The filter expression to apply to the data collection (e.g., createdAt > '2023-01-01').
  - `surrogate_keys` SurrogateKeySpec[], nullable — Per-table surrogate key(s) for parallel filtered snapshots (ENG-2474): the indexed column(s) to range over instead of the PK. Distinct from the source-wide surrogate_key below (incremental / blocking path).
    - `data_collection` string, required — The data collection (table) to apply the surrogate key to.
    - `surrogate_key` string[], required — Indexed column(s) to range + order over instead of the PK (single or composite).
  - `surrogate_key` string, nullable — Column name to use as surrogate primary key for all tables during snapshot chunking. Useful for tables without primary keys or when a more efficient column exists for chunking.
  - `filter_regex` string, nullable — Optional restrictive regex applied by the orchestrator to the physical tables the controller expands, across ALL triggered selectors. Matched (via search) against each physical's fully-qualified identifier `<database-or-schema>.<table>`, so it can narrow by DB/schema, table name, or a table-name suffix — the caller decides. Only matching physicals are snapshotted. Use to backfill a specific subset without re-snapshotting a regex source's full expansion. Null → no restriction.

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/streamkap/apis/streamkap-rest-api.md) · [All operations](https://skmtc.net/streamkap/apis/streamkap-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/streamkap/streamkap-rest-api/versions/8aea6143d003/schema)