Tag a data model

POST

/v2/dataModels/tag

POST

/v2/dataModels/tag

$ curl -X POST https://api.sigmacomputing.com/v2/dataModels/tag \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "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
> }'

200Request Example

1 {
2   "versionTagId": "string",
3   "taggedDataModelId": "string",
4   "taggedDataModelVersion": 1.1
5 }

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 endpoint.
Retrieve the tag by calling the /v2/tags endpoint and using the name in the response.
Retrieve the connectionId to use as the fromId or toId by calling the /v2/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 endpoint and use the versionTagId in the response.
To retrieve the versionTagId for a data model, call the /v2/dataModels endpoint and use the versionTagId in the response.

Usage scenarios

Lifecycle management: Identify production and development resources.

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.

Authentication

AuthorizationBearer

OAuth authentication of the form <token>.

Request

The request body.

dataModelIdstringRequired

Unique identifier of the data model.

tagstringRequired

Name of the version tag to apply.

dataModelVersiondoubleOptional

Specific version of the published data model to tag.

sourceMappingConfiglist of objectsOptional

Swap sources for the data model when you add a tag.

dataModelSourceTaggedVersionslist of objectsOptional

Which tagged version of the data model to use as the source.

isDefaultbooleanOptional

Whether to make this tag the default tagged version to load if the user doesn't have access to the published version.

Response

The response body.

versionTagIdstring

taggedDataModelIdstring

Unique identifier of the data model.

taggedDataModelVersiondouble