> ## Documentation Index
> Fetch the complete documentation index at: https://br.developers.hubspot.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Get rows from draft table

> Retorna linhas na versão de rascunho da tabela especificada. Os resultados das linhas podem ser filtrados e classificados. As opções de filtragem e classificação serão enviadas como parâmetros de consulta para a solicitação da API. Por exemplo, adicionando os parâmetros de consulta "column1__gt=5&sort=-column1", a API retorna as linhas com valores maiores que 5 na coluna "column1"  e na ordem decrescente. Consulte a seção [visão geral](https://developers.hubspot.com/docs/api/cms/hubdb#filtering-and-sorting-table-rows) para ver opções detalhadas de filtragem e classificação.

export const ScopesList = ({scopes = [], description = "Esta API requer um dos seguintes escopos:"}) => {
  if (!scopes || scopes.length === 0) {
    return null;
  }
  const sortedScopes = scopes.sort((a, b) => a.localeCompare(b));
  return <div>
      <div className="text-sm mb-2">{description}</div>
      <div>
        {sortedScopes.map((scope, index) => <div key={index}>
            <code>
              <span className="text-xs">{scope}</span>
            </code>
          </div>)}
      </div>
    </div>;
};

export const SupportedProducts = ({marketing, sales, service, cms, marketingLevel, salesLevel, serviceLevel, cmsLevel}) => {
  const translations = {
    header: "Produtos suportados",
    description: "Requer um dos seguintes produtos ou superior.",
    productNames: {
      marketing: "Marketing Hub",
      sales: "Sales Hub",
      service: "Service Hub",
      cms: "Content Hub"
    },
    tiers: {
      free: "Grátis",
      starter: "Starter",
      professional: "Professional",
      enterprise: "Enterprise"
    }
  };
  const translateTier = tier => {
    if (!tier) return '';
    const lowerTier = tier.toLowerCase();
    return translations.tiers[lowerTier] || tier;
  };
  const products = [{
    name: marketing ? translations.productNames.marketing : '',
    level: translateTier(marketingLevel),
    icon: "https://mintlify-assets.b-cdn.net/Icons/marketing-bolt.svg",
    alt: "Marketing Hub"
  }, {
    name: sales ? translations.productNames.sales : '',
    level: translateTier(salesLevel),
    icon: "https://mintlify-assets.b-cdn.net/Icons/sales-star.svg",
    alt: "Sales Hub"
  }, {
    name: service ? translations.productNames.service : '',
    level: translateTier(serviceLevel),
    icon: "https://mintlify-assets.b-cdn.net/Icons/service-heart.svg",
    alt: "Service Hub"
  }, {
    name: cms ? translations.productNames.cms : '',
    level: translateTier(cmsLevel),
    icon: "https://mintlify-assets.b-cdn.net/Icons/content-play.svg",
    alt: "Content Hub"
  }].filter(product => product.name && product.level);
  if (products.length === 0) return null;
  return <div>
      <div className="text-sm mb-2">{translations.description}</div>
      <div className={`grid ${products.length === 1 ? 'grid-cols-1' : 'grid-cols-2'} gap-1.5`}>
        {products.map((product, index) => <div key={index} style={{
    display: 'flex',
    alignItems: 'center'
  }}>
            <img src={product.icon} alt={product.alt} className="w-3.5 h-3.5 mr-1.5 mt-2.5 mb-2.5 flex-shrink-0 align-middle" />
            <span className="font-medium mr-1 text-sm">{product.name} -</span>
            <span className="text-sm">{product.level}</span>
          </div>)}
      </div>
    </div>;
};

<AccordionGroup>
  <Accordion title="Supported products" defaultOpen="true" icon="cubes">
    <SupportedProducts marketing={true} sales={true} service={true} cms={true} marketingLevel="PROFESSIONAL" salesLevel="FREE" serviceLevel="FREE" cmsLevel="PROFESSIONAL" />
  </Accordion>

  <Accordion title="Required Scopes" icon="key">
    <ScopesList
      scopes={[
  'hubdb'
]}
    />
  </Accordion>
</AccordionGroup>


## OpenAPI

````yaml specs/2026-03/cms-hubdb-v2026-03.json GET /cms/hubdb/2026-03/tables/{tableIdOrName}/rows/draft
openapi: 3.0.1
info:
  title: HubDB
  description: Basepom for all HubSpot Projects
  version: 2026-03
  x-hubspot-product-tier-requirements:
    marketing: PROFESSIONAL
    sales: FREE
    service: FREE
    cms: PROFESSIONAL
    commerce: FREE
    crmHub: FREE
    dataHub: FREE
servers:
  - url: https://api.hubapi.com
security: []
tags:
  - name: Linhas
  - name: Rows
  - name: Tabelas
  - name: Tables
paths:
  /cms/hubdb/2026-03/tables/{tableIdOrName}/rows/draft:
    get:
      tags:
        - Tabelas
        - Tables
      summary: Obter linhas de uma tabela de rascunho
      description: >-
        Retorna linhas na versão de rascunho da tabela especificada. Os
        resultados das linhas podem ser filtrados e classificados. As opções de
        filtragem e classificação serão enviadas como parâmetros de consulta
        para a solicitação da API. Por exemplo, adicionando os parâmetros de
        consulta "column1__gt=5&sort=-column1", a API retorna as linhas com
        valores maiores que 5 na coluna "column1"  e na ordem decrescente.
        Consulte a seção [visão
        geral](https://developers.hubspot.com/docs/api/cms/hubdb#filtering-and-sorting-table-rows)
        para ver opções detalhadas de filtragem e classificação.
      operationId: >-
        get-/cms/hubdb/2026-03/tables/{tableIdOrName}/rows/draft_readDraftTableRows
      parameters:
        - name: tableIdOrName
          in: path
          description: O ID ou nome da tabela a ser consultada.
          required: true
          style: simple
          explode: false
          schema:
            type: string
        - name: after
          in: query
          description: >-
            O token do cursor de paginação do último recurso lido com sucesso
            será retornado como a propriedade JSON "paging.next.after" de uma
            resposta paginada que contém mais resultados.
          required: false
          style: form
          explode: true
          schema:
            type: string
        - name: archived
          in: query
          description: Especifica se deve retornar linhas arquivadas. O padrão é "false".
          required: false
          style: form
          explode: true
          schema:
            type: boolean
        - name: limit
          in: query
          description: >-
            O número máximo de resultados a serem retornados. O padrão é
            "1.000".
          required: false
          style: form
          explode: true
          schema:
            type: integer
            format: int32
        - name: offset
          in: query
          description: >-
            O número de linhas a ignorar antes de começar a retornar os
            resultados.
          required: false
          style: form
          explode: true
          schema:
            type: integer
            format: int32
        - name: properties
          in: query
          description: >-
            Especifique os nomes das colunas para obter resultados contendo
            apenas as colunas necessárias em vez de todos os detalhes das
            colunas. Se deseja incluir várias colunas no resultado, use este
            parâmetro de consulta quantas vezes forem necessárias.
          required: false
          style: form
          explode: true
          schema:
            type: array
            items:
              type: string
        - name: sort
          in: query
          description: >-
            Especifica os nomes das colunas pelas quais classificar os
            resultados.
          required: false
          style: form
          explode: true
          schema:
            type: array
            items:
              type: string
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/UnifiedCollectionResponseWithTotalBaseHubDbTableRowV3
        default:
          $ref: '#/components/responses/Error'
          description: ''
      security:
        - oauth2:
            - hubdb
        - oauth2:
            - hubdb.rows.read
components:
  schemas:
    UnifiedCollectionResponseWithTotalBaseHubDbTableRowV3:
      properties: {}
      oneOf:
        - $ref: >-
            #/components/schemas/RandomAccessCollectionResponseWithTotalHubDbTableRowV3
        - $ref: >-
            #/components/schemas/StreamingCollectionResponseWithTotalHubDbTableRowV3
    RandomAccessCollectionResponseWithTotalHubDbTableRowV3:
      required:
        - results
        - total
        - type
      type: object
      properties:
        paging:
          $ref: '#/components/schemas/BoundedPaging'
        results:
          type: array
          items: 0a27e2f1-39fa-4c20-87c1-343316518956
        total:
          type: integer
          description: O número total de linhas disponíveis na coleção.
          format: int32
        type:
          type: string
          description: Indica o tipo de resposta, que por padrão é "RANDOM_ACCESS".
          default: RANDOM_ACCESS
          enum:
            - RANDOM_ACCESS
      x-hubspot-sub-type-impl: true
    StreamingCollectionResponseWithTotalHubDbTableRowV3:
      required:
        - results
        - total
        - type
      type: object
      properties:
        paging:
          $ref: '#/components/schemas/Paging'
        results:
          type: array
          items: 0a27e2f1-39fa-4c20-87c1-343316518956
        total:
          type: integer
          description: O número total de linhas disponíveis na coleção.
          format: int32
        type:
          type: string
          description: Indica o tipo de resposta, que por padrão é "STREAMING".
          default: STREAMING
          enum:
            - STREAMING
      x-hubspot-sub-type-impl: true
    Error:
      required:
        - category
        - correlationId
        - message
      type: object
      properties:
        category:
          type: string
          description: A categoria de erro
        context:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
          description: Contexto sobre a condição do erro
          example: >-
            {invalidPropertyName=[propertyValue], missingScopes=[scope1,
            scope2]}
        correlationId:
          type: string
          description: >-
            Um identificador exclusivo para a solicitação. Inclua este valor em
            relatórios de erro ou tickets de suporte
          format: uuid
          example: aeb5f871-7f07-4993-9211-075dc63e7cbf
        errors:
          type: array
          description: mais informações sobre o erro
          items:
            $ref: '#/components/schemas/ErrorDetail'
        links:
          type: object
          additionalProperties:
            type: string
          description: >-
            Um mapa de nomes de links para URIs associados que contêm
            documentação sobre o erro ou as etapas de correção recomendadas
        message:
          type: string
          description: >-
            Uma mensagem legível por humanos que descreve o erro, juntamente com
            as etapas de correção, quando apropriado
          example: An error occurred
        subCategory:
          type: string
          description: >-
            Uma categoria específica que contém mais detalhes específicos sobre
            o erro
      example:
        message: Invalid input (details will vary based on the error)
        correlationId: aeb5f871-7f07-4993-9211-075dc63e7cbf
        category: VALIDATION_ERROR
        links:
          knowledge-base: https://www.hubspot.com/products/service/knowledge-base
    BoundedPaging:
      type: object
      properties:
        next:
          $ref: '#/components/schemas/BoundedNextPage'
    Paging:
      type: object
      properties:
        next:
          $ref: '#/components/schemas/NextPage'
        prev:
          $ref: '#/components/schemas/PreviousPage'
    ErrorDetail:
      required:
        - message
      type: object
      properties:
        code:
          type: string
          description: O código de status associado ao detalhe do erro
        context:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
          description: Contexto sobre a condição do erro
          example: >-
            {invalidPropertyName=[propertyValue], missingScopes=[scope1,
            scope2]}
        in:
          type: string
          description: O nome do campo ou parâmetro no qual o erro foi encontrado.
        message:
          type: string
          description: >-
            Uma mensagem legível por humanos que descreve o erro, juntamente com
            as etapas de correção, quando apropriado
        subCategory:
          type: string
          description: >-
            Uma categoria específica que contém mais detalhes específicos sobre
            o erro
    BoundedNextPage:
      required:
        - offset
      type: object
      properties:
        link:
          type: string
          description: >-
            Um URL que pode ser usado para recuperar o próximo conjunto de
            resultados.
        offset:
          type: integer
          description: >-
            O valor de deslocamento que indica o ponto inicial para o próximo
            conjunto de resultados.
          format: int32
    NextPage:
      required:
        - after
      type: object
      properties:
        after:
          type: string
          description: Um token de cursor de paginação para recuperar páginas subsequentes.
        link:
          type: string
          description: >-
            Um URL que pode ser usado para recuperar os resultados da próxima
            página.
      description: >-
        Specifies the paging information needed to retrieve the next set of
        results in a paginated API response
    PreviousPage:
      required:
        - before
      type: object
      properties:
        before:
          type: string
          description: Um token de cursor de paginação para recuperar páginas anteriores.
        link:
          type: string
          description: >-
            Um URL que pode ser usado para recuperar os resultados das páginas
            anteriores.
      description: >-
        specifies the paging information needed to retrieve the previous set of
        results in a paginated API response
  responses:
    Error:
      description: An error occurred.
      content:
        '*/*':
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    oauth2:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://app.hubspot.com/oauth/authorize
          tokenUrl: https://api.hubapi.com/oauth/v1/token
          scopes:
            hubdb: ''

````