Update task with the Wrike API
Updates the fields sent of a task and keeps the others. To complete it, send status Completed or a custom status of the Completed group. Lists and objects go as JSON text.
- Identifier
- wrike_update_task
The request
POST https://connect.reportei.com/api/tools/wrike_update_task/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"taskId": "<taskId>"
}
}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
| Parameter | Type | Required | Description |
|---|---|---|---|
| taskId | string | Yes | Id of the task, from List tasks or Search tasks. |
| title | string | No | New title. |
| description | string | No | New description, in plain text or in the limited HTML that Wrike accepts. |
| status | string | No | New status. Not available on the Team plan.Values: Active, Deferred, Completed, Cancelled |
| customStatus | string | No | Id of a custom status from List workflows, for a workflow status such as In review. Use it instead of status. |
| importance | string | No | New importance.Values: High, Normal, Low |
| dates | string | No | JSON object with the dates of the task: type (Planned, Backlog or Milestone), start and due as yyyy-MM-dd with an optional THH:mm:ss, duration in minutes (one Wrike day is 480), and workOnWeekends. A start needs a due or a duration. Example: {"type":"Planned","start":"2026-11-03","due":"2026-11-07"}. When changing duration, send start and due again, or Wrike clears them. |
| addResponsibles | string | No | Users to assign: JSON array of user ids from List contacts, such as ["KUAJ25LC"]. |
| removeResponsibles | string | No | Users to unassign: JSON array of user ids from List contacts, such as ["KUAJ25LC"]. |
| addParents | string | No | Folders to also put the task in: JSON array of folder ids from List folders, such as ["IEAAAAAAI4AAAAAA"]. |
| removeParents | string | No | Folders to take the task out of: JSON array of folder ids from List folders. |
| restore | boolean | No | True to bring the task back from the Recycle Bin. |
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_update_task. It becomes your agent's tool definition with no conversion.
Other Wrike tools
- List foldersGETLists 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.
- Create folderPOSTCreates a folder inside a space, folder or project, or a project when project is sent. Requires title. Lists and objects go as JSON text.
- Update folderPUTUpdates the fields sent of a folder or project and keeps the others, such as the title, the project status, dates and owners, or the folders that hold it. Lists and objects go as JSON text.
- List tasksGETLists 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.
- Search tasksGETSearches the tasks of the whole account, such as the tasks assigned to someone or due this week, up to 1000 per page. When the response brings nextPageToken, send it to fetch the next page.
- Get taskGETReturns one or more tasks with their description, assignees, dates, status, custom status, the folders that hold them, custom fields and subtasks.
- Create taskPOSTCreates a task in a space, folder or project. Requires title. Without dates the task goes to the backlog. Lists and objects go as JSON text.
- Delete taskDELETEMoves a task to the Recycle Bin. Update task with restore true brings it back.
Toolkits in the same category
See all 100 toolkitsSee Connect applied to your product.
Try it for 15 days with no card, or walk our team through your use case.
