> ## 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.

# Search folders

> Pesquise pastas no gerenciador de arquivos da HubSpot usando vários parâmetros de consulta para filtrar os resultados. Este endpoint permite recuperar pastas com base em critérios específicos, como data de criação, data de atualização, nome da pasta e IDs de pastas principais. Ele oferece suporte à paginação e à classificação para ajudar a gerenciar grandes conjuntos de dados com eficiência.

> **Supported products**

> **Required Scopes**


## OpenAPI

````yaml specs/2026-09/files-files-v2026-09.json GET /files/2026-09/folders/search
openapi: 3.0.1
info:
  title: Files Files
  description: Basepom for all HubSpot Projects
  version: 2026-09
  x-hubspot-product-tier-requirements:
    marketing: FREE
    sales: FREE
    service: FREE
    cms: FREE
    commerce: FREE
    crmHub: FREE
    dataHub: FREE
servers:
  - url: https://api.hubapi.com
security: []
tags:
  - name: Files
  - name: Folders
paths:
  /files/2026-09/folders/search:
    get:
      tags:
        - Folders
      summary: Pesquisar pastas
      description: >-
        Pesquise pastas no gerenciador de arquivos da HubSpot usando vários
        parâmetros de consulta para filtrar os resultados. Este endpoint permite
        recuperar pastas com base em critérios específicos, como data de
        criação, data de atualização, nome da pasta e IDs de pastas principais.
        Ele oferece suporte à paginação e à classificação para ajudar a
        gerenciar grandes conjuntos de dados com eficiência.
      operationId: get-/files/2026-09/folders/search
      parameters:
        - name: after
          in: query
          description: >-
            Um token de cursor para paginação. Use o valor do campo
            paging.next.after da resposta anterior.
          required: false
          style: form
          explode: true
          schema:
            type: string
        - name: before
          in: query
          description: >-
            Um token de cursor para paginação. Use o valor do campo
            paging.prev.before da resposta anterior.
          required: false
          style: form
          explode: true
          schema:
            type: string
        - name: createdAt
          in: query
          description: Pastas filtradas criadas nesta data/hora exata.
          required: false
          style: form
          explode: true
          schema:
            type: string
            format: date-time
        - name: createdAtGte
          in: query
          description: >-
            Filtre resultados em que a data de criação é maior ou igual a esta
            data/hora.
          required: false
          style: form
          explode: true
          schema:
            type: string
            format: date-time
        - name: createdAtLte
          in: query
          description: >-
            Filtre resultados para pastas criadas nesta data/hora ou antes
            disso.
          required: false
          style: form
          explode: true
          schema:
            type: string
            format: date-time
        - name: idGte
          in: query
          description: >-
            Filtre resultados para incluir apenas pastas com IDs maiores ou
            iguais a este valor.
          required: false
          style: form
          explode: true
          schema:
            type: integer
            format: int64
        - name: idLte
          in: query
          description: Filtrar para incluir pastas com IDs menores ou iguais a este valor.
          required: false
          style: form
          explode: true
          schema:
            type: integer
            format: int64
        - name: ids
          in: query
          description: Uma lista de IDs de pasta para filtrar os resultados.
          required: false
          style: form
          explode: true
          schema:
            type: array
            items:
              type: integer
              format: int64
        - name: limit
          in: query
          description: O número máximo de resultados a serem exibidos por página.
          required: false
          style: form
          explode: true
          schema:
            type: integer
            format: int32
        - name: name
          in: query
          description: Filtre pastas por este nome.
          required: false
          style: form
          explode: true
          schema:
            type: string
        - name: parentFolderIds
          in: query
          description: Uma lista de IDs de pastas pai para filtrar os resultados.
          required: false
          style: form
          explode: true
          schema:
            type: array
            items:
              type: integer
              format: int64
        - name: path
          in: query
          description: Filtrar resultados para pastas com este caminho específico.
          required: false
          style: form
          explode: true
          schema:
            type: string
        - name: properties
          in: query
          description: Uma lista de nomes de propriedades a serem incluídos na resposta.
          required: false
          style: form
          explode: true
          schema:
            type: array
            items:
              type: string
        - name: sort
          in: query
          description: Uma lista de nomes de propriedades pela qual classificar a resposta.
          required: false
          style: form
          explode: true
          schema:
            type: array
            items:
              type: string
        - name: updatedAt
          in: query
          description: >-
            Filtre os resultados para incluir apenas pastas atualizadas nesta
            data/hora exata.
          required: false
          style: form
          explode: true
          schema:
            type: string
            format: date-time
        - name: updatedAtGte
          in: query
          description: >-
            Filtre resultados para pastas atualizadas nesta data/hora ou depois
            disso.
          required: false
          style: form
          explode: true
          schema:
            type: string
            format: date-time
        - name: updatedAtLte
          in: query
          description: Pastas filtradas atualizadas nesta data/hora ou antes disso.
          required: false
          style: form
          explode: true
          schema:
            type: string
            format: date-time
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CollectionResponseFolder'
        default:
          $ref: '#/components/responses/Error'
          description: ''
      security:
        - oauth2:
            - files.ui_hidden.read
components:
  schemas:
    CollectionResponseFolder:
      required:
        - results
      type: object
      properties:
        paging:
          $ref: '#/components/schemas/Paging'
        results:
          type: array
          description: >-
            Uma matriz de objetos de pasta, cada um representando uma pasta
            dentro do gerenciador de arquivos.
          items:
            $ref: '#/components/schemas/Folder'
    Paging:
      type: object
      properties:
        next:
          $ref: '#/components/schemas/NextPage'
        prev:
          $ref: '#/components/schemas/PreviousPage'
      description: >-
        Representa as informações de paginação para navegar por uma lista de
        resultados na API. Ele fornece detalhes sobre como acessar o conjunto
        anterior ou seguinte de resultados.
    Folder:
      required:
        - archived
        - createdAt
        - id
        - updatedAt
      type: object
      properties:
        archived:
          type: boolean
          description: Um booleano que indica se a pasta está arquivada.
        archivedAt:
          type: string
          description: A data e a hora em que a pasta foi arquivada, no formato ISO 8601.
          format: date-time
        createdAt:
          type: string
          description: A data e hora em que a pasta foi criada, no formato ISO 8601.
          format: date-time
        id:
          type: string
          description: O ID exclusivo da pasta, representado como uma string.
        name:
          type: string
          description: O nome da pasta, representado como uma string.
        parentFolderId:
          type: string
          description: >-
            O identificador exclusivo da pasta pai, representado como uma
            string.
        path:
          type: string
          description: >-
            O caminho da pasta dentro do sistema de arquivos, representado como
            uma string.
        updatedAt:
          type: string
          description: A data e a hora da última atualização da pasta, no formato ISO 8601.
          format: date-time
    Error:
      required:
        - category
        - correlationId
        - message
      type: object
      properties:
        category:
          type: string
          description: A categoria do erro, representada como uma string.
        context:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
          description: >-
            Contexto sobre a condição de erro, representado como um objeto com
            propriedades adicionais que são arrays de strings.
          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. É uma string no formato
            UUID.
          format: uuid
          example: aeb5f871-7f07-4993-9211-075dc63e7cbf
        errors:
          type: array
          description: >-
            Uma matriz que fornece mais informações sobre o erro, com cada item
            sendo um objeto ErrorDetail.
          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 etapas de correção recomendadas,
            representado como um objeto com propriedades de string.
        message:
          type: string
          description: >-
            Uma mensagem legível por humanos que descreve o erro, juntamente com
            as etapas de correção, quando apropriado. É uma string.
          example: An error occurred
        subCategory:
          type: string
          description: >-
            Uma categoria específica que contém mais detalhes específicos sobre
            o erro. É uma string.
      description: >-
        Representa uma resposta de erro retornada pela API quando uma operação
        falha. Este componente é usado em vários endpoints para fornecer
        informações detalhadas sobre o erro encontrado.
      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
    NextPage:
      required:
        - after
      type: object
      properties:
        after:
          type: string
          description: >-
            Um token de string usado para recuperar a próxima página de
            resultados.
        link:
          type: string
          description: >-
            Um URL de string que fornece o link para acessar a próxima página de
            resultados.
      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 string que representa o cursor para a página anterior de
            resultados.
        link:
          type: string
          description: >-
            Um URL de string que fornece um link para a página de resultados
            anterior.
      description: >-
        specifies the paging information needed to retrieve the previous set of
        results in a paginated API response
    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 de erro, representado como um objeto com
            propriedades adicionais que são arrays de strings.
          example: '{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. É uma string.
        subCategory:
          type: string
          description: >-
            Uma categoria específica que contém detalhes mais específicos sobre
            o erro. Esta é uma string.
      description: >-
        Representa informações detalhadas sobre um erro ocorrido na API. Este
        componente é usado para fornecer contexto e detalhes adicionais sobre os
        erros, geralmente como parte de uma resposta de erro.
  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:
            files.ui_hidden.read: ''
            files.ui_hidden.write: ''

````