---
title: "PUT /api/table/{id}"
method: PUT
path: "/api/table/{id}"
tags: ["/api/table"]
---

# PUT /api/table/{id}

`PUT /api/table/{id}`

Update `Table` with ID.

## Path parameters

- `id` integer, required

## Request body

- object
  - `caveats` string, nullable
  - `collection_id` integer, nullable — value must be an integer greater than zero.
  - `data_authority` 'computed' | 'authoritative' | 'unconfigured' | 'ingested' — Schema for writing a valid table data authority.
  - `data_layer` string, nullable
  - `data_source` string, nullable
  - `description` string, nullable
  - `display_name` string, nullable
  - `entity_type` unknown
  - `field_order` 'alphabetical' | 'custom' | 'database' | 'smart', nullable
  - `owner_email` string, nullable
  - `owner_user_id` integer, nullable
  - `points_of_interest` string, nullable
  - `show_in_getting_started` boolean, nullable
  - `visibility_type` 'technical' | 'hidden' | 'cruft', nullable

## Response `2XX`

Successful response

## Other responses

- `4XX` — Client error response
- `5XX` — Server error response

## Changes

> 13 revisions in range; 1 could not be searched.

- **2026-05-22** `b1dc4ea67567` — 1 info
  - added the new optional request property `collection_id`
- **2026-03-09** `78297d193ca4` — 1 info
  - api operation id `put-api-table-id` was added

[Change history](https://skmtc.dev/metabase/apis/metabase-api/changes/api/table/:id/put.md)

---

[API](https://skmtc.dev/metabase/apis/metabase-api.md) · [All operations](https://skmtc.dev/metabase/apis/metabase-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/metabase/metabase-api/revisions/e879e0319b12/schema)