Pular para o conteúdo principal
GET
/
files
/
2026-03
/
folders
/
search
Pesquisar pastas
curl --request GET \
  --url https://api.hubapi.com/files/2026-03/folders/search \
  --header 'Authorization: Bearer <token>'
{
  "results": [
    {
      "archived": true,
      "createdAt": "2023-11-07T05:31:56Z",
      "id": "<string>",
      "updatedAt": "2023-11-07T05:31:56Z",
      "archivedAt": "2023-11-07T05:31:56Z",
      "name": "<string>",
      "parentFolderId": "<string>",
      "path": "<string>"
    }
  ],
  "paging": {
    "next": {
      "after": "<string>",
      "link": "<string>"
    },
    "prev": {
      "before": "<string>",
      "link": "<string>"
    }
  }
}

Supported products

Autorizações

Authorization
string
header
obrigatório

The access token received from the authorization server in the OAuth 2.0 flow.

Parâmetros de consulta

after
string

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.

before
string

Pesquise as pastas atualizadas antes desta data/hora. A hora deve estar em milissegundos de época.

createdAt
string<date-time>

Pesquise pastas pela hora exata de criação. A hora deve estar em milissegundos de época.

createdAtGte
string<date-time>

Pesquise pastas por hora maior ou igual à hora de criação. Pode ser usado com createdAtLte para criar um intervalo.

createdAtLte
string<date-time>

Pesquise pastas por hora menor ou igual à hora de criação. Pode ser usado com createdAtGte para criar um intervalo.

idGte
integer<int64>

Pesquise as pastas por ID maior ou igual a um valor. Pode ser usado com idLte para criar um intervalo.

idLte
integer<int64>

Pesquise as pastas por ID menor ou igual a um valor. Pode ser usado com idGte para criar um intervalo.

ids
integer<int64>[]

Pesquise as pastas por vários IDs. Uma lista de IDs de pasta separados por vírgulas.

limit
integer<int32>

O número máximo de resultados a serem exibidos por página.

name
string

Pesquise pastas que contêm o nome especificado.

parentFolderIds
integer<int64>[]

Pesquise pastas com o folderId principal especificado.

path
string

Pesquise pastas por caminho.

properties
string[]

Propriedades que devem ser incluídas nas pastas retornadas.

sort
string[]

Classifique os resultados pela propriedade especificado. Por exemplo, -name classifica pelo campo de nome em ordem decrescente; name classifica pelo campo de nome em ordem crescente.

updatedAt
string<date-time>

Pesquise pastas pela hora exata da última atualização. A hora deve estar em milissegundos de época.

updatedAtGte
string<date-time>

Pesquise pastas por hora maior ou igual à hora da última atualização. Pode ser usado com updatedAtLte para criar um intervalo.

updatedAtLte
string<date-time>

Pesquise pastas por hora menor ou igual à hora da última atualização. Pode ser usado com updatedAtGte para criar um intervalo.

Resposta

successful operation

results
object[]
obrigatório
paging
object
Last modified on April 13, 2026