--- title: "Unpublish a table" method: POST path: "/cms/hubdb/2026-03/tables/{tableIdOrName}/unpublish" tags: ["Tables"] --- # Unpublish a table `POST /cms/hubdb/2026-03/tables/{tableIdOrName}/unpublish` ## Request - Base URL: `https://api.hubapi.com` - URL: `https://api.hubapi.com/cms/hubdb/2026-03/tables/{tableIdOrName}/unpublish` - Auth: one of: - OAuth 2 - Authorization code: `https://app.hubspot.com/oauth/authorize` - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `hubdb` - OAuth 2 - Authorization code: `https://app.hubspot.com/oauth/authorize` - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `hubdb.tables.publish` Unpublishes the table, meaning any website pages using data from the table will not render any data. ## Path parameters - `tableIdOrName` string, required ## Query parameters - `includeForeignIds` boolean ## Response `200` successful operation - HubDbTableV3 - `allowChildTables` boolean, required: Specifies whether child tables can be created - `allowPublicApiAccess` boolean, required: Specifies whether the table can be read by public without authorization - `columnCount` integer, required: Number of columns including deleted - `columns` Column[], required: List of columns in the table - `createdAt` string, date-time: The timestamp when the column was created. - `createdBy` SimpleUser - `email` string, required: The email address of the user. - `firstName` string, required: The first name of the user. - `id` string, required: The unique identifier for the user. - `lastName` string, required: The last name of the user. - `createdByUserId` integer: The ID of the user who created the column. - `deleted` boolean, required: Indicates whether the column has been deleted. - `description` string, required: The description of the column. - `foreignColumnId` integer: Foreign Column id - `foreignIds` ForeignId[]: Foreign Ids - `id` string, required: Unique identifier for the foreign ID. - `name` string, required: Name of the foreign ID. - `type` string, required: Type of the foreign ID. - `foreignIdsById` object: Foreign ids - `foreignIdsByName` object: Foreign ids by name - `foreignTableId` integer: Foreign table id referenced - `id` string, required: Column Id - `label` string, required: Label of the column - `name` string, required: Name of the column - `optionCount` integer: Number of options available - `options` Option[]: Options to choose for select and multi-select columns - `createdAt` string, date-time, required: The timestamp when the option was created, in ISO 8601 format. - `createdBy` SimpleUser - `email` string, required: The email address of the user. - `firstName` string, required: The first name of the user. - `id` string, required: The unique identifier for the user. - `lastName` string, required: The last name of the user. - `createdByUserId` integer: The ID of the user who created the option. - `id` string, required: The unique ID of the option. - `label` string, required: A user-friendly label that identifies the option. - `name` string, required: An internal name assigned to the option, distinct from the label. - `order` integer, required: The order in which the option appears, represented as an integer. - `type` string, required: Indicates the category or data type of the option (e.g., string, number). - `updatedAt` string, date-time, required: The timestamp when the option was last updated, in ISO 8601 format. - `updatedBy` SimpleUser - `email` string, required: The email address of the user. - `firstName` string, required: The first name of the user. - `id` string, required: The unique identifier for the user. - `lastName` string, required: The last name of the user. - `updatedByUserId` integer: The ID of the user who last updated the option. - `type` 'BOOLEAN' | 'CODE' | 'COMPOSITE' | 'CTA' | 'CURRENCY' | 'DATE' | 'DATETIME' | 'EMBED' | 'FILE' | 'FOREIGN_ID' | 'HUBSPOT_VIDEO' | 'IMAGE' | 'JSON' | 'LOCATION' | 'MULTISELECT' | 'NULL' | 'NUMBER' | 'RICHTEXT' | 'SELECT' | 'TEXT' | 'URL' | 'VIDEO', required: Type of the column - `updatedAt` string, date-time: The timestamp when the column was last updated. - `updatedBy` SimpleUser - `email` string, required: The email address of the user. - `firstName` string, required: The first name of the user. - `id` string, required: The unique identifier for the user. - `lastName` string, required: The last name of the user. - `updatedByUserId` integer: The ID of the user who last updated the column. - `width` integer: Column width for HubDB UI - `createdAt` string, date-time, required: Timestamp at which the table is created - `createdBy` SimpleUser - `email` string, required: The email address of the user. - `firstName` string, required: The first name of the user. - `id` string, required: The unique identifier for the user. - `lastName` string, required: The last name of the user. - `deleted` boolean, required: Specifies whether the table is marked as deleted. - `deletedAt` string, date-time, required: The timestamp indicating when the table was deleted. - `dynamicMetaTags` object, required: Specifies the key value pairs of the [metadata fields](https://developers.hubspot.com/docs/cms/guides/dynamic-pages/hubdb#dynamic-pages) with the associated column IDs. - `enableChildTablePages` boolean, required: Specifies creation of multi-level dynamic pages using child tables - `id` string, required: Id of the table - `isOrderedManually` boolean: Indicates whether the table rows are ordered manually. - `label` string, required: Label of the table - `name` string, required: Name of the table - `published` boolean, required: Indicates whether the table is currently published. - `publishedAt` string, date-time, required: Timestamp at which the table is published recently - `rowCount` integer, required: Number of rows in the table - `updatedAt` string, date-time, required: Timestamp at which the table is updated recently - `updatedBy` SimpleUser - `email` string, required: The email address of the user. - `firstName` string, required: The first name of the user. - `id` string, required: The unique identifier for the user. - `lastName` string, required: The last name of the user. - `useForPages` boolean, required: Specifies whether the table can be used for creation of dynamic pages ## Other responses - `default`: An error occurred. ## Changes - **2026-11-02** (2026-03) `57dfaa14c811`: 2 info - the security scope `hubdb` was added to the endpoint's security scheme `oauth2` - the security scope `hubdb.tables.publish` was removed from the endpoint's security scheme `oauth2` - **2026-09-10** (2026-03) `f907bc4f599c`: 3 info - the security scope `hubdb.tables.publish` was added to the endpoint's security scheme `oauth2` - the security scope `hubdb-publish` was removed from the endpoint's security scheme `oauth2` - the security scope `hubdb-unpublish` was removed from the endpoint's security scheme `oauth2` - **2026-09-09** (2026-03) `aae1075c6909`: 3 info - the security scope `hubdb-publish` was added to the endpoint's security scheme `oauth2` - the security scope `hubdb-unpublish` was added to the endpoint's security scheme `oauth2` - the security scope `hubdb.tables.publish` was removed from the endpoint's security scheme `oauth2` - **2026-09-07** (2026-03) `531201597da3`: 2 info - the security scope `hubdb` was added to the endpoint's security scheme `oauth2` - the security scope `hubdb.tables.publish` was removed from the endpoint's security scheme `oauth2` - **2026-09-04** (2026-03) `6b6a597c6598`: 2 info - the security scope `hubdb` was added to the endpoint's security scheme `oauth2` - the security scope `hubdb.tables.publish` was removed from the endpoint's security scheme `oauth2` [Operation history](https://skmtc.dev/hubspot/apis/cms-hubdb/changes/cms/hubdb/2026-03/tables/:tableIdOrName/unpublish/post.md) --- [API](https://skmtc.dev/hubspot/apis/cms-hubdb.md) - [All operations](https://skmtc.dev/hubspot/apis/cms-hubdb/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/cms-hubdb/revisions/57dfaa14c811?raw)