---
title: "Sync a connection by path"
method: POST
path: "/v2/connections/{connectionId}/sync"
tags: ["Connections"]
---

# Sync a connection by path

`POST /v2/connections/{connectionId}/sync`

## Request

- Base URL: `https://api.sigmacomputing.com`
- URL: `https://api.sigmacomputing.com/v2/connections/{connectionId}/sync`
- Auth: HTTP bearer

Sync the connection for a data source to retrieve any changes from the data warehouse.

  ### Usage notes
  - Specify the path to a table, stored procedure, schema, or database in your data warehouse that you want to sync. To trigger a full connection sync, provide an empty path (`[]`).
  - Retrieve the **connectionId** by calling the [/v2/connections](https://help.sigmacomputing.com/reference/list-connections) endpoint.
  - Different connections support different paths:

    - For a Snowflake connection, you can specify `DATABASE.SCHEMA.TABLE`, `DATABASE.SCHEMA.STORED_PROCEDURE`, or a less-specific path.
    - For Amazon Redshift, you can specify `SCHEMA.TABLE`, `SCHEMA.STORED_PROCEDURE`, or a less-specific path.
    - For Databricks, you can specify `CATALOG.SCHEMA.TABLE` or a less-specific path.

## Path parameters

- `connectionId` string, required

## Query parameters

- `useServiceAccount` boolean

## Request body

- object
  - `path` union, required
    - string[]
    - string[]
    - string[]
    - unknown[]
      - unknown

## Response `200`

The response body.

- ConnectionsSyncConnectionPathResponse200

---

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