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>"
}
}
}フォルダーを検索します。非表示のフォルダーやアーカイブされたフォルダーは含まれません。
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
Required Scopes
The access token received from the authorization server in the OAuth 2.0 flow.
最後に正常に読み取られたリソースのページ操作カーソルトークンは、より多くの結果を含むページ付きレスポンスのpaging.next.after JSONプロパティーとして返されます。
このタイムスタンプより前に更新されたフォルダーを検索します。時刻はエポック時間(ミリ秒単位)にする必要があります。
作成時間に完全一致するフォルダーを検索します。時間はエポック時間(ミリ秒)である必要があります。
作成時間以上のフォルダーを検索します。createdAtLteと一緒に使用して範囲を作成できます。
作成時間以下のフォルダーを検索します。createdAtGteと一緒に使用して範囲を作成できます。
IDが指定値以上のフォルダーを検索します。idLteと一緒に使用して範囲を作成できます。
ID以下のフォルダーを検索します。idGteと一緒に使用して範囲を作成できます。
複数のIDでフォルダーを検索します。フォルダーIDのカンマ区切りリストです。
ページごとに表示する結果の最大数。
指定した名前が含まれるフォルダーを検索します。
指定した親folderIdのフォルダーを検索します。
パスでフォルダーを検索します。
返されるフォルダーに含まれるプロパティー。
指定したプロパティーを基準に結果の表示順を変更します。例えば、-nameでは名前フィールドを基準に降順で表示順を変更し、nameでは名前フィールドを基準に照準で表示順を変更します。
最終更新時間に完全一致するフォルダーを検索します。時間はエポック時間(ミリ秒)である必要があります。
最終更新時間以上のフォルダーを検索します。updatedAtLteと一緒に使用して範囲を作成できます。
最終更新時間以下のフォルダーを検索します。updatedAtGteと一緒に使用して範囲を作成できます。