Skip to main content
PUT
Replace the tag settings of a data platform

Authorizations

Authorization
string
header
required

Organization API key (sl_…).

Headers

If-Match
string | null

The current ETag of the tag settings, from a prior read. Required: the request is rejected if the tag settings have changed since.

x-tenant-id
string
required

The organization ID the request is scoped to.

Path Parameters

connection_type
enum<string>
required
Available options:
snowflake,
databricks,
bigquery,
aws

Body

application/json

The tag keys that SELECT reads for each tag domain, keyed by domain. A null value or an empty list means no tag keys for that domain. The domains are user, role, warehouse, database and object_level for Snowflake; jobs, clusters, pipelines, warehouses, endpoints and queries for Databricks; jobs, reservations, datasets and tables for BigQuery; and tags for AWS.

{key}
string[] | null

Response

Successful Response

The tag keys that SELECT reads from one data platform's resources.

connection_type
enum<string>
required
read-only

The data platform that the tag keys apply to.

Available options:
snowflake,
databricks,
bigquery,
aws
tag_keys
Tag Keys · object
required

The tag keys that SELECT reads for each tag domain, keyed by domain. A null value or an empty list means no tag keys for that domain. The domains are user, role, warehouse, database and object_level for Snowflake; jobs, clusters, pipelines, warehouses, endpoints and queries for Databricks; jobs, reservations, datasets and tables for BigQuery; and tags for AWS.

etag
string
required
read-only

Opaque strong ETag for the tag settings. Matches the ETag response header, and is what If-Match requires on a write.