Update field metadata
Merges the given key-value pairs into the Arrow field metadata for the specified column. Field metadata is stored in the Delta Lake schema and persists across versions. Use this for display names, descriptions, or domain hints. **Required scope:** `tables:modify`
Authorization
BearerAuth Security scheme for OpenAPI endpoints. Validates both JWT tokens and API keys.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Request to update the metadata of a single table field.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X PUT "https://example.com/v1/tables/{catalog}/{schema}/{table_name}/fields/metadata" \ -H "Content-Type: application/json" \ -d '{ "fieldName": "string", "metadata": { "property1": null, "property2": null } }'{}{ "code": "string", "message": "string", "request_id": "string", "details": [ { "field": "string", "message": "string" } ]}{ "code": "string", "message": "string", "request_id": "string", "details": [ { "field": "string", "message": "string" } ]}{ "code": "string", "message": "string", "request_id": "string", "details": [ { "field": "string", "message": "string" } ]}{ "code": "string", "message": "string", "request_id": "string", "details": [ { "field": "string", "message": "string" } ]}{ "code": "string", "message": "string", "request_id": "string", "details": [ { "field": "string", "message": "string" } ]}{ "code": "string", "message": "string", "request_id": "string", "details": [ { "field": "string", "message": "string" } ]}{ "code": "string", "message": "string", "request_id": "string", "details": [ { "field": "string", "message": "string" } ]}{ "code": "string", "message": "string", "request_id": "string", "details": [ { "field": "string", "message": "string" } ]}{ "code": "string", "message": "string", "request_id": "string", "details": [ { "field": "string", "message": "string" } ]}Rollback table to a previous version
Restores the Delta Lake table to the state at the specified version number by creating a new commit that reverts all subsequent changes. The rollback itself is recorded as a new version in the transaction log. **Required scope:** `tables:modify`
Update column settings (uniqueness, primary key, nullable) with data validation
When enabling `isUnique`, the engine checks for duplicate non-NULL values. When enabling `isPrimaryKey`, the engine checks that the new composite key set has no duplicate combinations. When setting `isNullable` to `false`, the engine checks for existing NULL values. Disabling uniqueness/primary key or enabling nullable is always safe. **Required scope:** `tables:modify`