Update Table

Updates table properties like name and order using either table ID or table name.

PATCH /bases/{databaseId}/tables/{tableId}

Update table

cURL

curl --request PATCH \
  --url https://tables.fillout.com/api/v1/bases/{databaseId}/tables/{tableId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>"
}
'

200

Example

{
  "id": "<string>",
  "name": "<string>",
  "order": 123,
  "primaryFieldId": "<string>",
  "fields": [
    {
      "id": "<string>",
      "name": "<string>",
      "type": "single_line_text",
      "template": {},
      "order": 123
    }
  ],
  "views": [
    {
      "id": "<string>",
      "name": "<string>",
      "type": "<string>",
      "config": {
        "sorts": [
          {}
        ],
        "hiddenFieldIds": [
          "<string>"
        ],
        "fieldWidths": {},
        "orderedFieldIds": [
          "<string>"
        ]
      }
    }
  ],
  "url": "https://build.fillout.com/database/bad4b276-f604-47ad-86e5-d2ae4f60968f/tbl_abc123"
}

Modifies table properties including name and display order within the database using either the table ID or table name.

• Only provided fields will be updated
• Omitted fields retain their current values
• Order determines table position in database navigation

Authorizations

Authorization · string · header · required

Enter your Fillout API key. Format: Bearer <api_key>

Path Parameters

databaseId · string · required

The unique identifier of the database

tableId · string · required

The unique identifier of the table. You can also use the table name instead of the ID.

Body

application/json

name · string

New table name

Minimum string length: 1

Response

200

application/json

Table updated successfully

id · string · required

Unique identifier for the table

name · string · required

Name of the table

order · integer · required

Display order of the table

primaryFieldId · string · required

ID of the primary field in the table

fields · object[] · required

List of fields in the table

Show child attributes

views · object[] · required

List of views in the table

Show child attributes

url · string<uri> · required

URL to view this table in the app

Example:

"https://build.fillout.com/database/bad4b276-f604-47ad-86e5-d2ae4f60968f/tbl_abc123"