Skip to main content
POST
/
v2
/
task.update
UpdateTask
curl --request POST \
  --url https://api.manus.ai/v2/task.update \
  --header 'Content-Type: application/json' \
  --data '
{
  "task_id": "<string>"
}
'
{
  "ok": true,
  "request_id": "<string>",
  "task_id": "<string>",
  "task_title": "<string>",
  "task_url": "<string>",
  "share_url": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://open.manus.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

Questions or issues? Contact us at api-support@manus.ai.
OAuth scope: create_task or manage_all_tasks — see the OAuth2 guide. With create_task scope, can only access tasks created by this OAuth app.

Headers

​
x-manus-api-key
string

API key for direct authentication. Provide either this or Authorization, not both. See Authentication.

​
Authorization
string

OAuth2 access token in Bearer {token} format. Provide either this or x-manus-api-key, not both. See the OAuth2 guide.

Example:

"Bearer {access_token}"

Body

application/json
​
task_id
string
required

The unique identifier of the task to update. Supports the shortcut agent-default-main_task for the IM agent's main task.

​
title
string

New title for the task. Replaces the auto-generated title.

​
share_visibility
enum<string>

Controls who can view the task. "private" — only the task creator can view. "team" — all team members can view. "public" — anyone with the share_url can view.

Available options:
private,
team,
public
​
enable_visible_in_task_list
boolean

When true, the task appears in the Manus webapp task list. When false, hides the task from the list (still accessible via direct URL).

Response

Task updated successfully.

​
ok
boolean

Whether the request was successful.

Example:

true

​
request_id
string

Unique identifier for this API request.

​
task_id
string

The ID of the updated task.

​
task_title
string

The current title of the task.

​
task_url
string

URL to view the task in the Manus webapp.

​
share_url
string

Public share URL. Only present when share_visibility is not "private".

​
share_visibility
enum<string>

The actual visibility state of the task.

Available options:
private,
team,
public