Update a table

Last updated February 1, 2019

PUT /hubdb/api/v2/tables/:tableId

Method Details

HTTP Methods:


Content Type:


Response Format:


Requires Authentication?


Rate Limited?






Required Scope:


Update an existing HubDB table. You can use this endpoint to add or remove a column, or to publish a table that's ready to be used.

Table updates will modify the draft table. Use the /publish  endpoint to push all changes live.

Required Parameters How to use Description
OAuth Access Token or API Key Authorization: Bearer {token} header
or hapikey={key} query parameter.
Used to authenticate the request. Please see this page for more details about authentication.

Optional Parameters How to use Description
Update Draft details /draft
Used in the request URL
Include /draft at the end of the request path to update the draft version of the table.
Name "name": {new name}
Used in the request
Renames the table
Use for pages "useForPages": {true or false}
Used in the request
Set this to true to enable the table for dynamic pages.
Published at "publishedAt":{millisecond timestamp
Used in the request
Set this to the current (or a past) time to publish a table that's ready to be used
Columns "columns": [ {column list} ]
Used in the request
Updates the columns in the table. See creating a table for the column definitions.
IMPORTANT: Data in this field overwrites the existing columns. If you want to add a new column, you'll need to include the existing columns and the new column in the request.