List tasks with the Wrike API

Lists the tasks of a space, folder or project, up to 1000 per page. When the response brings nextPageToken, send it to fetch the next page.

Identifier
wrike_list_tasks

The request

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

{
  "customer_toolkit": "<connection UUID>",
  "arguments": {
    "folderId": "<folderId>"
  }
}

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
folderIdstringYesId of the space, folder or project, from List folders.
descendantsbooleanNoTrue to include the tasks of the folders and projects inside it.
titlestringNoOnly tasks whose title contains this text.
statusstringNoOnly tasks in these statuses: JSON array of statuses, any of Active, Deferred, Completed and Cancelled, such as ["Active"].
importancestringNoOnly tasks with this importance.Values: High, Normal, Low
responsiblesstringNoOnly tasks assigned to any of these users: JSON array of user ids from List contacts, such as ["KUAJ25LC"].
customStatusesstringNoOnly tasks in these custom statuses: JSON array of custom status ids from List workflows, such as ["IEAAAAAAJMAAAAAA"].
startDatestringNoStart 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"}.
dueDatestringNoDue 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"}.
createdDatestringNoCreated 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"}.
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"}.
completedDatestringNoCompleted 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"}.
typestringNoOnly tasks of this type: Planned has dates, Backlog has none, Milestone has only a due date.Values: Planned, Backlog, Milestone
subTasksbooleanNoTrue to also search the subtasks.
sortFieldstringNoField the tasks are sorted by.Values: Status, Importance, UpdatedDate, CreatedDate, Title, StartFinishInterval, DueDate, LastAccessDate, CompletedDate
sortOrderstringNoSort order.Values: Asc, Desc
pageSizeintegerNoTasks per page, up to 1000.
nextPageTokenstringNoThe nextPageToken of the previous response, to fetch the next page. Send the same fields again.
fieldsstringNoJSON array of optional fields to add to each task, such as ["responsibleIds","description","customFields"]. Assignees and description only come when asked here.

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_tasks. It becomes your agent's tool definition with no conversion.

Other Wrike tools

See all 13 tools

Toolkits in the same category

See all 100 toolkits

See Connect applied to your product.

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