---
title: "Add dbt metadata for a connection"
method: POST
path: "/v2/connections/{connectionId}/dbtArtifacts"
tags: ["Connections"]
---

# Add dbt metadata for a connection

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

## Request

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

Add dbt run artifacts for a given connection. For more details, see [Configure dbt Core integration](/docs/manage-dbt-integration#configure-dbt-core-integration-beta).

  ### Usage notes
  - Retrieve the **connectionId** by calling the [/v2/connections](https://help.sigmacomputing.com/reference/list-connections) endpoint.
  - Create a tar.gz file containing the target directory of your dbt project that contains run artifacts.
  - Provide the file in the request with the field name 'artifacts'.

## Path parameters

- `connectionId` string, required

## Request body `multipart/form-data`

- object
  - `artifacts` string, binary, required: Compressed (tar.gz) file containing the artifacts of a dbt run.

## Response `201`

The dbt artifacts were added to the connection.

- ConnectionsPostConnectionDbtArtifactsResponse201: The dbt artifacts were added to the connection.

---

[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)