Tag a report

POST

/v2/reports/tag

POST

/v2/reports/tag

$ curl -X POST https://api.sigmacomputing.com/v2/reports/tag \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "reportId": "00000000-0000-0000-0000-000000000000",
>   "tagName": "production",
>   "reportVersion": 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   "taggedReportId": "string",
4   "taggedReportVersion": 1.1
5 }

Add a version tag to a report and optionally set up a connection to swap to for a specific version of the report.

Usage notes

Retrieve the reportId by calling the /v2/reports endpoint.
Retrieve the tagName 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 report 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 report:
- 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 report 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 report source, call the /v2/reports/{reportId}/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 report and optionally set up a connection to swap to for a specific version of the report. ### Usage notes - Retrieve the **reportId** by calling the [/v2/reports](https://help.sigmacomputing.com/reference/list-reports) endpoint. - Retrieve the **tagName** 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 report 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 report: - 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 report 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 report source, call the [/v2/reports/{reportId}/sources](https://help.sigmacomputing.com/reference/list-report-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.

reportIdstringRequired

Unique identifier of the report.

tagNamestringRequired

Name of the version tag to apply.

reportVersiondoubleOptional

Specific version of the published report to tag.

sourceMappingConfiglist of objectsOptional

Swap sources for the report 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

taggedReportIdstring

Unique identifier of the report.

taggedReportVersiondouble