Skip to main content
PATCH
PATCH /v1/tables/{id}

Update a Table

Update a table’s properties using JSON Merge Patch. You can update by ID or by fully qualified name.

Update by ID

string
required
UUID of the table to update.

Update by Name

Use PATCH /v1/tables/name/{fqn} to update by fully qualified name.
string
required
Fully qualified name of the table (e.g., snowflake_prod.analytics.public.customers).

Body Parameters

Send a JSON object with the fields to update. Only provided fields are changed.
string
Updated description in Markdown format.
string
Updated display name.
array
Updated list of owner references.
array
Updated classification tags.
string
Updated retention period in ISO 8601 duration format.
array
Updated column definitions. Use this to update column descriptions, tags, or add new columns.
string
Updated domain FQN.
object
Updated custom property values.
PATCH /v1/tables/{id}

Returns

Returns the updated table object with the new version number.

Response

string
Unique identifier for the table (UUID format).
string
Table name.
string
Fully qualified name in format service.database.schema.table.
string
Updated description.
number
Incremented version number.

Error Handling