---
title: "Get Folders (Space)"
method: GET
path: "/spaces/{spaceId}/folders"
tags: ["Folders & Projects"]
---

# Get Folders (Space)

`GET /spaces/{spaceId}/folders`

Returns the list of folders from a specific space in the current account.<br>
The method operates in two modes:<br>
<ul>
<li><b>Folder Tree Mode</b>: Activated if no filter parameters are provided. This mode returns the required
space, it's descendant folders, the root folder, and the recycle bin folder (note that "deleted" parameter
can affect the result, see below).
Filtering can be requested in this mode using the descendants=true parameter along with filter parameters.

<li><b>Folders Mode</b>: Activated if the parameter descendant=false is specified or if there is at least
one filter parameter, e.g., project=true. This mode returns only required space's folders filtered by the
specified parameters.
</ul>
The chosen mode can be identified by the "kind" key in the result JSON body, with "kind": "folderTree"
for Folder Tree Mode and "kind": "folders" for Folders Mode.

<b>Scopes:</b> Default, wsReadOnly, wsReadWrite

## Path parameters

- `spaceId` string, required

## Query parameters

- `permalink` string — Folder permalink, exact match
- `descendants` boolean — Adds all descendant folders to search scope
- `withInvitations` boolean — Include invitations in sharedIds list
- `project` boolean — Filter only projects (true) / only folders (false)
- `deleted` boolean — Get folders from Root (false) / Recycle Bin (true). This parameter does not affect method's mode.
- `plainTextCustomFields` boolean — Strip HTML tags from custom fields
- `pageSize` number — The number of folders to return (max 1000 items per page). Only 'folders' kind is supported
- `nextPageToken` string — A pagination request will return a token that applies an offset to the next page. The returned value should be used as an input parameter in the next request. Parameter pageSize can be omitted in this case. If you included optional fields to the first request, you will need to include those in each new call. Only 'folders' kind is supported
- `title` string — Title filter, contains match and accepts non-blank values only

## Response `2XX`

success response

- object
  - `data` Folder[]
    - `folder-id` string, required
    - `title` string, required
  - `kind` 'accounts' | 'users' | 'contacts' | 'assets' | 'eDiscoveryReport' | 'folders' | 'folderTree' | 'tasks' | 'taskIds' | 'timelogs' | 'timelogCategories' | 'timelogLockPeriods' | 'timetrackerTimers' | 'comments' | 'attachments' | 'url' | 'version' | 'dataExport' | 'dataExportSchema' | 'auditLog' | 'accessRoles' | 'stream' | 'changes' | 'posts' | 'mailSettings' | 'integrationInfo' | 'gmailIntegrationSettings' | 'workTypesForIntegrations' | 'ids' | 'backups' | 'domains' | 'dependencies' | 'workflows' | 'workschedules' | 'workscheduleExclusions' | 'workscheduleUserExclusions' | 'customfields' | 'customfieldIds' | 'customstatuses' | 'invitations' | 'notifications' | 'jobroles' | 'placeholders' | 'groups' | 'session' | 'dashboards' | 'widgets' | 'taskCreationSettings' | 'colors' | 'experiments' | 'topics' | 'topicComments' | 'webhooks' | 'reviews' | 'boards' | 'textSearch' | 'chatChannels' | 'chatMessages' | 'forms' | 'requestForms' | 'request' | 'report' | 'platformWidgets' | 'platformWidgetInstances' | 'spaces' | 'pdf' | 'customerSatisfaction' | 'asyncJob' | 'approvals' | 'highlights' | 'highlightsList' | 'highlightsSettings' | 'highlightsCard' | 'timesheet' | 'timesheetRow' | 'timesheetSubmissionRule' | 'mobileFeatures' | 'mobileSettings' | 'folderBlueprintTree' | 'taskBlueprintTree' | 'feedback' | 'timeline_snapshot' | 'contactIds' | 'bookings' | 'integrateThreshold' | 'hourlyRatesProvision' | 'hourlyRates' | 'projectTeamMembers' | 'contactsHistory' | 'tasksHistory' | 'foldersHistory' | 'activityDigest' | 'workItemTemplates' | 'workTemplates' | 'workItemMetadata' | 'workItem' | 'customItemTypes' | 'verificationCode' | 'views' | 'listView' | 'tableView' | 'userTypes' | 'reactions' | 'externalRequesters' | 'workscheduleCapacityOverrides' | 'userCapacityOverrides' | 'userCapacityExclusions' | 'rollups' | 'requestFormPrefill' | 'userAggregatedCapacity' | 'cascadingFieldSettings'

## Other responses

- `4XX` — client-side error response
- `5XX` — server-side error response

---

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