> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://help.sigmacomputing.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://help.sigmacomputing.com/_mcp/server. # Tag a data model POST https://api.sigmacomputing.com/v2/dataModels/tag Content-Type: application/json Add a version tag to a data model and optionally set up a connection to swap to for a specific version of the data model. ### Usage notes * Retrieve the **dataModelId** by calling the [/v2/dataModels](https://help.sigmacomputing.com/reference/list-data-models) endpoint. * Retrieve the **tag** by calling the [/v2/tags](https://help.sigmacomputing.com/reference/list-version-tag) endpoint and using the `name` in the response. * Retrieve the **connectionId** to use as the **fromId** or **toId** by calling the [/v2/connections](https://help.sigmacomputing.com/reference/list-connections) endpoint. * If your data model includes a source that is not mapped to a new source, that source is not swapped. * When swapping data models used as the source for the data model: * You can only swap a data model source to another version of the same data model source. You cannot swap a data model source to a table in your data warehouse or a dataset. * When you swap sources from one data model version to a new one, specify the version tag of the data model that you swap to with `toVersionTagId`: * To swap to the latest published version of the data model, specify `toVersionTagId` as `null`. * To swap to a specific tagged version of the data model, specify the `toVersionTagId` of the data model. * If the data model already uses a specific tagged version of a data model as a source, use `fromVersionTagId` to indicate which tagged version to swap from. * To swap from the latest published version of the data model, specify `fromVersionTagId` as `null`. * To swap from a specific tagged version of the data model, specify the `fromVersionTagId` of the data model. * To retrieve the `fromVersionTagId` for a data model used as the data model source, call the [/v2/dataModels/\{dataModelId}/sources](https://help.sigmacomputing.com/reference/list-data-model-sources) endpoint and use the `versionTagId` in the response. * To retrieve the `versionTagId` for a data model, call the [/v2/dataModels](https://help.sigmacomputing.com/reference/list-data-models) endpoint and use the `versionTagId` in the response. ### Usage scenarios * **Lifecycle management**: Identify production and development resources. Reference: https://help.sigmacomputing.com/reference/tag-data-model ## Authentication - OAuth2 — send the obtained token as `Authorization: Bearer ` ## Servers - `https://api.sigmacomputing.com` (Server for GCP (US) hosted organizations, default) - `https://api.sa.gcp.sigmacomputing.com` (Server for GCP (KSA) hosted organizations) - `https://aws-api.sigmacomputing.com` (Server for AWS US (West) hosted organizations) - `https://api.us-a.aws.sigmacomputing.com` (Server for AWS US (East) hosted organizations) - `https://api.ca.aws.sigmacomputing.com` (Server for AWS Canada hosted organizations) - `https://api.eu.aws.sigmacomputing.com` (Server for AWS Europe hosted organizations) - `https://api.au.aws.sigmacomputing.com` (Server for AWS Australia and APAC hosted organizations) - `https://api.uk.aws.sigmacomputing.com` (Server for AWS UK hosted organizations) - `https://api.us.azure.sigmacomputing.com` (Server for Azure US hosted organizations) - `https://api.eu.azure.sigmacomputing.com` (Server for Azure Europe hosted organizations) - `https://api.ca.azure.sigmacomputing.com` (Server for Azure Canada hosted organizations) - `https://api.uk.azure.sigmacomputing.com` (Server for Azure United Kingdom hosted organizations) - `https://api.au.azure.sigmacomputing.com` (Server for Azure Australia hosted organizations) ## Request ### Body (application/json) - `dataModelId` (string, required) — Unique identifier of the data model. - `tag` (string, required) — Name of the version tag to apply. - `dataModelVersion` (double, optional) — Specific version of the published data model to tag. - `sourceMappingConfig` (list of object, optional) — Swap sources for the data model when you add a tag. - `fromConnectionId` (string, required) - `toConnectionId` (string, required) - `paths` (list of object, required) - `fromPath` (list of string, required) - `toPath` (list of string, required) - `dataModelSourceTaggedVersions` (list of object, optional) — Which tagged version of the data model to use as the source. - `dataModelId` (string, required) - `fromVersionTagId` (string, required, nullable) - `toVersionTagId` (string, required, nullable) - `isDefault` (boolean, optional) — Whether to make this tag the default tagged version to load if the user doesn't have access to the published version. ## Response ### 200 The response body. - `versionTagId` (string, required) - `taggedDataModelId` (string, required) — Unique identifier of the data model. - `taggedDataModelVersion` (double, required) ## Examples **Request** ```json { "dataModelId": "00000000-0000-0000-0000-000000000000", "tag": "production", "dataModelVersion": 4, "sourceMappingConfig": [ { "fromConnectionId": "00000000-0000-0000-0000-000000000000", "toConnectionId": "00000000-0000-0000-0000-000000000001", "paths": [ { "fromPath": [ "SNOWFLAKE_DEVELOPMENT", "WEATHER", "DAILY_14_TOTAL" ], "toPath": [ "SNOWFLAKE_PRODUCTION", "WEATHER", "DAILY_16_TOTAL" ] } ] } ], "isDefault": true } ``` **Response** ```json { "versionTagId": "string", "taggedDataModelId": "string", "taggedDataModelVersion": 1.1 } ``` **SDK Code** ```python Request Example import requests url = "https://api.sigmacomputing.com/v2/dataModels/tag" payload = { "dataModelId": "00000000-0000-0000-0000-000000000000", "tag": "production", "dataModelVersion": 4, "sourceMappingConfig": [ { "fromConnectionId": "00000000-0000-0000-0000-000000000000", "toConnectionId": "00000000-0000-0000-0000-000000000001", "paths": [ { "fromPath": ["SNOWFLAKE_DEVELOPMENT", "WEATHER", "DAILY_14_TOTAL"], "toPath": ["SNOWFLAKE_PRODUCTION", "WEATHER", "DAILY_16_TOTAL"] } ] } ], "isDefault": True } headers = { "Authorization": ".", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Request Example const url = 'https://api.sigmacomputing.com/v2/dataModels/tag'; const options = { method: 'POST', headers: {Authorization: '.', 'Content-Type': 'application/json'}, body: '{"dataModelId":"00000000-0000-0000-0000-000000000000","tag":"production","dataModelVersion":4,"sourceMappingConfig":[{"fromConnectionId":"00000000-0000-0000-0000-000000000000","toConnectionId":"00000000-0000-0000-0000-000000000001","paths":[{"fromPath":["SNOWFLAKE_DEVELOPMENT","WEATHER","DAILY_14_TOTAL"],"toPath":["SNOWFLAKE_PRODUCTION","WEATHER","DAILY_16_TOTAL"]}]}],"isDefault":true}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Request Example package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.sigmacomputing.com/v2/dataModels/tag" payload := strings.NewReader("{\n \"dataModelId\": \"00000000-0000-0000-0000-000000000000\",\n \"tag\": \"production\",\n \"dataModelVersion\": 4,\n \"sourceMappingConfig\": [\n {\n \"fromConnectionId\": \"00000000-0000-0000-0000-000000000000\",\n \"toConnectionId\": \"00000000-0000-0000-0000-000000000001\",\n \"paths\": [\n {\n \"fromPath\": [\n \"SNOWFLAKE_DEVELOPMENT\",\n \"WEATHER\",\n \"DAILY_14_TOTAL\"\n ],\n \"toPath\": [\n \"SNOWFLAKE_PRODUCTION\",\n \"WEATHER\",\n \"DAILY_16_TOTAL\"\n ]\n }\n ]\n }\n ],\n \"isDefault\": true\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", ".") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Request Example require 'uri' require 'net/http' url = URI("https://api.sigmacomputing.com/v2/dataModels/tag") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = '.' request["Content-Type"] = 'application/json' request.body = "{\n \"dataModelId\": \"00000000-0000-0000-0000-000000000000\",\n \"tag\": \"production\",\n \"dataModelVersion\": 4,\n \"sourceMappingConfig\": [\n {\n \"fromConnectionId\": \"00000000-0000-0000-0000-000000000000\",\n \"toConnectionId\": \"00000000-0000-0000-0000-000000000001\",\n \"paths\": [\n {\n \"fromPath\": [\n \"SNOWFLAKE_DEVELOPMENT\",\n \"WEATHER\",\n \"DAILY_14_TOTAL\"\n ],\n \"toPath\": [\n \"SNOWFLAKE_PRODUCTION\",\n \"WEATHER\",\n \"DAILY_16_TOTAL\"\n ]\n }\n ]\n }\n ],\n \"isDefault\": true\n}" response = http.request(request) puts response.read_body ``` ```java Request Example import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.sigmacomputing.com/v2/dataModels/tag") .header("Authorization", ".") .header("Content-Type", "application/json") .body("{\n \"dataModelId\": \"00000000-0000-0000-0000-000000000000\",\n \"tag\": \"production\",\n \"dataModelVersion\": 4,\n \"sourceMappingConfig\": [\n {\n \"fromConnectionId\": \"00000000-0000-0000-0000-000000000000\",\n \"toConnectionId\": \"00000000-0000-0000-0000-000000000001\",\n \"paths\": [\n {\n \"fromPath\": [\n \"SNOWFLAKE_DEVELOPMENT\",\n \"WEATHER\",\n \"DAILY_14_TOTAL\"\n ],\n \"toPath\": [\n \"SNOWFLAKE_PRODUCTION\",\n \"WEATHER\",\n \"DAILY_16_TOTAL\"\n ]\n }\n ]\n }\n ],\n \"isDefault\": true\n}") .asString(); ``` ```php Request Example request('POST', 'https://api.sigmacomputing.com/v2/dataModels/tag', [ 'body' => '{ "dataModelId": "00000000-0000-0000-0000-000000000000", "tag": "production", "dataModelVersion": 4, "sourceMappingConfig": [ { "fromConnectionId": "00000000-0000-0000-0000-000000000000", "toConnectionId": "00000000-0000-0000-0000-000000000001", "paths": [ { "fromPath": [ "SNOWFLAKE_DEVELOPMENT", "WEATHER", "DAILY_14_TOTAL" ], "toPath": [ "SNOWFLAKE_PRODUCTION", "WEATHER", "DAILY_16_TOTAL" ] } ] } ], "isDefault": true }', 'headers' => [ 'Authorization' => '.', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Request Example using RestSharp; var client = new RestClient("https://api.sigmacomputing.com/v2/dataModels/tag"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "."); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"dataModelId\": \"00000000-0000-0000-0000-000000000000\",\n \"tag\": \"production\",\n \"dataModelVersion\": 4,\n \"sourceMappingConfig\": [\n {\n \"fromConnectionId\": \"00000000-0000-0000-0000-000000000000\",\n \"toConnectionId\": \"00000000-0000-0000-0000-000000000001\",\n \"paths\": [\n {\n \"fromPath\": [\n \"SNOWFLAKE_DEVELOPMENT\",\n \"WEATHER\",\n \"DAILY_14_TOTAL\"\n ],\n \"toPath\": [\n \"SNOWFLAKE_PRODUCTION\",\n \"WEATHER\",\n \"DAILY_16_TOTAL\"\n ]\n }\n ]\n }\n ],\n \"isDefault\": true\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Request Example import Foundation let headers = [ "Authorization": ".", "Content-Type": "application/json" ] let parameters = [ "dataModelId": "00000000-0000-0000-0000-000000000000", "tag": "production", "dataModelVersion": 4, "sourceMappingConfig": [ [ "fromConnectionId": "00000000-0000-0000-0000-000000000000", "toConnectionId": "00000000-0000-0000-0000-000000000001", "paths": [ [ "fromPath": ["SNOWFLAKE_DEVELOPMENT", "WEATHER", "DAILY_14_TOTAL"], "toPath": ["SNOWFLAKE_PRODUCTION", "WEATHER", "DAILY_16_TOTAL"] ] ] ] ], "isDefault": true ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.sigmacomputing.com/v2/dataModels/tag")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```