---
title: "Return all draft tables"
method: GET
path: "/cms/hubdb/2026-03/tables/draft"
tags: ["Tables"]
---

# Return all draft tables

`GET /cms/hubdb/2026-03/tables/draft`

Returns the details for each draft table defined in the specified account, including column definitions.

## Query parameters

- `after` string
- `archived` boolean
- `contentType` string
- `createdAfter` string, date-time
- `createdAt` string, date-time
- `createdBefore` string, date-time
- `isGetLocalizedSchema` boolean
- `limit` integer
- `sort` string[]
- `updatedAfter` string, date-time
- `updatedAt` string, date-time
- `updatedBefore` string, date-time

## Response `200`

successful operation

- CmsHubdbCollectionResponseWithTotalHubDbTableV3
  - `paging` Paging
    - `next` NextPage — Specifies the paging information needed to retrieve the next set of results in a paginated API response
      - `after` string, required — A paging cursor token for retrieving subsequent pages.
      - `link` string — A URL that can be used to retrieve the next page results.
    - `prev` PreviousPage — specifies the paging information needed to retrieve the previous set of results in a paginated API response
      - `before` string, required — A string token used to identify the position before the current page in the pagination sequence.
      - `link` string — A URL string that provides a direct link to the previous page of results.
  - `results` CmsHubdbHubDbTableV3[], required
    - `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` CmsHubdbColumn[], required — List of columns in the table
      - `createdAt` string, date-time — The timestamp when the column was created.
      - `createdBy` CmsHubdbSimpleUser
        - `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` CmsHubdbForeignId[] — 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` CmsHubdbOption[] — 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` CmsHubdbSimpleUser
          - `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` CmsHubdbSimpleUser
          - `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` CmsHubdbSimpleUser
        - `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` CmsHubdbSimpleUser
      - `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` CmsHubdbSimpleUser
      - `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
  - `total` integer, required

## Other responses

- `default` — An error occurred.

---

[API](https://skmtc.net/hubspot/apis/hubspot-api-specification.md) · [All operations](https://skmtc.net/hubspot/apis/hubspot-api-specification/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hubspot/hubspot-api-specification/versions/f9c7181056c5/schema)