List folders with the Wrike API

Lists the spaces, folders and projects of the account. Without filters it returns the whole folder tree, with the id, title, childIds and scope of each item, the root folder of the account included (scope WsRoot). Any filter returns a flat list with the full fields, including the status and dates of projects, up to 1000 per page.

Identifier
wrike_list_folders

The request

POST https://connect.reportei.com/api/tools/wrike_list_folders/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json

{
  "customer_toolkit": "<connection UUID>",
  "arguments": {
    "project": true
  }
}

Your system sends your customer's connection id and the tool arguments. The headers are the same as the rest of the Connect API: your product's token and your customer's token.

Parameters

ParameterTypeRequiredDescription
projectbooleanNoTrue to return only projects, false to return only folders.
titlestringNoOnly folders whose title contains this text.
permalinkstringNoPermalink of a folder or project, as Wrike shows it, to find that one.
ownersstringNoOnly projects owned by any of these users: JSON array of user ids from List contacts, such as ["KUAJ25LC"].
customStatusesstringNoOnly projects in these custom statuses: JSON array of custom status ids from List workflows.
startDatestringNoProject start date filter: JSON object with an exact date in equal, or a range in start and end, as yyyy-MM-dd with an optional THH:mm:ss, such as {"start":"2026-11-01","end":"2026-11-30"}.
endDatestringNoProject end date filter: JSON object with an exact date in equal, or a range in start and end, as yyyy-MM-dd with an optional THH:mm:ss, such as {"start":"2026-11-01","end":"2026-11-30"}.
completedDatestringNoProject completion date filter: JSON object with an exact date in equal, or a range in start and end, as yyyy-MM-dd with an optional THH:mm:ss, such as {"start":"2026-11-01","end":"2026-11-30"}.
updatedDatestringNoUpdated date filter: JSON object with start and end in UTC, as yyyy-MM-ddTHH:mm:ssZ, such as {"start":"2026-11-01T00:00:00Z","end":"2026-11-30T23:59:59Z"}.
deletedbooleanNoTrue to list the folders in the Recycle Bin instead.
pageSizeintegerNoFolders per page, up to 1000. Works only with a filter.
nextPageTokenstringNoThe nextPageToken of the previous response, to fetch the next page. Send the same filters again.
fieldsstringNoJSON array of optional fields to add to each folder, such as ["description","customFields"].

Supported connections

Your customer connects their Wrike account once, with one of the modes below. The same connection serves every tool of the toolkit.

OAuth with your product's app

You register your product's OAuth app once, with POST /api/merchants/credentials/wrike, and your customer authorizes the account on a consent screen. Connect renews the token when it is about to expire.

When connecting, your customer also enters {host}: the address of their account on the app's API.

The response

On success, Connect preserves the app's response status and body. HTTP errors returned by the app use the {error, api_error} envelope; authentication or validation can fail before execution. The X-Toolkit-Execution-Id header identifies the recorded execution, available at GET /api/tools/executions/{uuid}.

Ready for AI agents

This tool's input is a JSON Schema, available at GET /api/tools/wrike_list_folders. It becomes your agent's tool definition with no conversion.

See Connect applied to your product.

Try it for 15 days with no card, or walk our team through your use case.