---
title: "Update a table"
method: PUT
path: "/tables/{tableId}"
tags: ["tables"]
---

# Update a table

`PUT /tables/{tableId}`

Update a table, this could be internal or external.

## Path parameters

- `tableId` string, required

## Headers

- `x-budibase-app-id` string, required

## Request body

- Table — The table to be created/updated.
  - `name` string, required — The name of the table.
  - `primaryDisplay` string — The name of the column which should be used in relationship tags when relating to this table.
  - `schema` object, required

## Response `200`

Returns the updated table.

- TableOutput
  - `data` object, required — The table to be created/updated.
    - `name` string, required — The name of the table.
    - `primaryDisplay` string — The name of the column which should be used in relationship tags when relating to this table.
    - `schema` object, required
    - `_id` string, required — The ID of the table.

## Changes

- **2025-03-11** `a08581a55595` — 2 breaking, 2 info
  - removed `subschema #1, subschema #2, subschema #3` from the `schema/additionalProperties/` request property `oneOf` list
  - added `subschema #1, subschema #2, subschema #3` to the `data/schema/additionalProperties/` response property `oneOf` list for the response status `200`
  - added `subschema #1, subschema #2, subschema #3` to the `schema/additionalProperties/` request property `oneOf` list
  - removed `subschema #1, subschema #2, subschema #3` from the `data/schema/additionalProperties/` response property `oneOf` list for the response status `200`
- **2024-10-30** `ac3872ebf1f7` — 1 breaking, 1 info
  - removed the enum value `ai` of the request property `schema/additionalProperties/oneOf[subschema #2]/formulaType`
  - removed the `ai` enum value from the `data/schema/additionalProperties/oneOf[subschema #2]/formulaType` response property for the response status `200`
- **2024-10-25** `8f1194cf2bd1` — 1 warning, 1 info
  - added the new `ai` enum value to the `data/schema/additionalProperties/oneOf[subschema #2]/formulaType` response property for the response status `200`
  - added the new `ai` enum value to the request property `schema/additionalProperties/oneOf[subschema #2]/formulaType`
- …earlier changes not shown

[Full history](https://skmtc.dev/budibase/apis/budibase-api/changes/tables/:tableId/put.md)

---

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