---
title: "POST /v1/{+name}:run"
method: POST
path: "/v1/{+name}:run"
tags: ["projects"]
---

# POST /v1/{+name}:run

`POST /v1/{+name}:run`

Use this method to start, resume or recover a stream with a non default CDC strategy.

## Path parameters

- `name` string, required

## Request body

- RunStreamRequest — Request message for running a stream.
  - `cdcStrategy` CdcStrategy — The strategy that the stream uses for CDC replication.
    - `mostRecentStartPosition` MostRecentStartPosition — CDC strategy to start replicating from the most recent position in the source.
    - `specificStartPosition` SpecificStartPosition — CDC strategy to start replicating from a specific position in the source.
      - `sqlServerLsnPosition` SqlServerLsnPosition — SQL Server LSN position
        - `lsn` string — Required. Log sequence number (LSN) from where Logs will be read
      - `spannerChangeStreamPosition` SpannerChangeStreamPosition — Represents a position in a Spanner change stream from which to start replicating.
        - `startTime` string, google-datetime — Required. The timestamp to start change stream queries from. The timestamp must be a positive value.
      - `mysqlLogPosition` MysqlLogPosition — MySQL log position
        - `logFile` string — Required. The binary log file name.
        - `logPosition` integer — Optional. The position within the binary log file. Default is head of file.
      - `mysqlGtidPosition` MysqlGtidPosition — MySQL GTID position
        - `gtidSet` string — Required. The gtid set to start replication from.
      - `mongodbChangeStreamPosition` MongodbChangeStreamPosition — MongoDB change stream position
        - `startTime` string, google-datetime — Required. The timestamp to start change stream from.
      - `oracleScnPosition` OracleScnPosition — Oracle SCN position
        - `scn` string, int64 — Required. SCN number from where Logs will be read
    - `nextAvailableStartPosition` NextAvailableStartPosition — CDC strategy to resume replication from the next available position in the source.
  - `force` boolean — Optional. Update the stream without validating it.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/datastream.md) · [All operations](https://skmtc.net/google/apis/datastream/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/datastream/versions/f9da70538976/schema)