Updates the name and/or description of a table. At least one of name or description must be specified.
Tables
Update table
patch
https://api.airtable.com/v0/meta/bases/{baseId}/tables/{tableIdOrName}
Authentication | Personal access token, OAuth integration |
Scope | schema.bases:write |
User role | Base creator |
Billing plans | All plans |
optional< string > The new description for the table (optional). If present, must be a string no longer than 20,000 characters. | |
optional< string > The new name for the table (optional). |
string | |||||||||||
string The first column in the table and every view. | |||||||||||
string | |||||||||||
optional< string > | |||||||||||
array of the below object
| |||||||||||
array of the below object
|
Request (example)
Copy
$curl -X PATCH "https://api.airtable.com/v0/meta/bases/{baseId}/tables/{tableIdOrName}" \-H "Authorization: Bearer YOUR_TOKEN" \-H "Content-Type: application/json" \--data '{"description": "I was changed!","name": "Apartments (revised)"}'
200 – Response (example)
{"description": "I was changed!","fields": [{"id": "fld1VnoyuotSTyxW1","name": "Name","type": "singleLineText"},{"id": "fldoi0c3GaRQJ3xnI","name": "Address","type": "singleLineText"},{"id": "fldumZe00w09RYTW6","name": "Visited","options": {"color": "redBright","icon": "star"},"type": "checkbox"}],"id": "tbltp8DGLhqbUmjK1","name": "Apartments (revised)","primaryFieldId": "fld1VnoyuotSTyxW1","views": [{"id": "viwQpsuEDqHFqegkp","name": "Grid view","type": "grid"}]}