> ## 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.

# task.update

> Updates a task's metadata (title, sharing, visibility, archive state). Use [task.detail](https://open.manus.ai/docs/v2/task.detail) to see the current values before updating.

<sup>Questions or issues? Contact us at [api-support@manus.ai](mailto:api-support@manus.ai).</sup>

> [!TIP]
>
> **Auth:**
>
> * **API Key:** Full access.
> * **Standard OAuth client:** Requires `create_task` or `manage_all_tasks`. With `create_task`, only tasks created by the same client; see [Task visibility](https://open.manus.ai/docs/v2/open-app.md#task-visibility).
> * **Trusted client:** Full access.


## OpenAPI

````yaml POST /v2/task.update
openapi: 3.1.0
info:
  title: Manus OpenAPI v2
  description: >-
    API for integrating Manus into your workflow. All responses are wrapped with
    {"ok": true, "request_id": "...", ...} for success and {"ok": false,
    "request_id": "...", "error": {"code": "...", "message": "..."}} for errors.
  version: 2.0.0
servers:
  - url: https://api.manus.ai
security:
  - ApiKeyAuth: []
paths:
  /v2/task.update:
    post:
      summary: UpdateTask
      description: >-
        Updates a task's metadata (title, sharing, visibility, archive state).
        Use [task.detail](https://open.manus.ai/docs/v2/task.detail) to see the
        current values before updating.
      operationId: openapi.v2.OpenapiV2Service.UpdateTask
      parameters:
        - name: x-manus-api-key
          in: header
          required: false
          schema:
            type: string
          description: >-
            API key for direct authentication. Provide either this or
            `Authorization`, not both. See
            [Authentication](https://open.manus.ai/docs/v2/authentication).
        - name: Authorization
          in: header
          required: false
          schema:
            type: string
            example: Bearer {access_token}
          description: >-
            OAuth2 access token in `Bearer {token}` format. An OAuth client
            requires the `create_task` or `manage_all_tasks` scope unless it is
            a `Trusted team client` or `Trusted public client`. Provide either
            this or `x-manus-api-key`, not both. See the [Open
            App](https://open.manus.ai/docs/v2/open-app) guide.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                task_id:
                  type: string
                  description: >-
                    The unique identifier of the task to update. Supports the
                    shortcut `agent-default-main_task` for the IM agent's main
                    task.
                title:
                  type: string
                  description: New title for the task. Replaces the auto-generated title.
                share_visibility:
                  type: string
                  enum:
                    - private
                    - team
                    - public
                  description: >-
                    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.
                enable_visible_in_task_list:
                  type: boolean
                  description: >-
                    When true, the task appears in the Manus webapp task list.
                    When false, hides the task from the list (still accessible
                    via direct URL).
                is_archived:
                  type: boolean
                  description: >-
                    Set `true` to archive the task or `false` to unarchive it.
                    This is the same archive state as in the Manus webapp, where
                    archived tasks move from the task list to the archived tasks
                    list. Only the task owner can change it. Agent main tasks
                    and agent subtasks cannot be archived and return
                    `invalid_argument`.
              required:
                - task_id
      responses:
        '200':
          description: Task updated successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                    example: true
                    description: Whether the request was successful.
                  request_id:
                    type: string
                    description: Unique identifier for this API request.
                  task_id:
                    type: string
                    description: The ID of the updated task.
                  task_title:
                    type: string
                    description: The current title of the task.
                  task_url:
                    type: string
                    description: URL to view the task in the Manus webapp.
                  share_url:
                    type: string
                    description: >-
                      Public share URL. Only present when share_visibility is
                      not "private".
                  share_visibility:
                    type: string
                    enum:
                      - private
                      - team
                      - public
                    description: The actual visibility state of the task.
        4XX:
          description: Error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security: []
components:
  schemas:
    ErrorResponse:
      type: object
      description: Standard error response format returned when a request fails.
      properties:
        ok:
          type: boolean
          example: false
          description: Always false for error responses.
        request_id:
          type: string
          description: >-
            Unique identifier for this API request, useful for debugging with
            support.
        error:
          type: object
          description: Error details.
          properties:
            code:
              type: string
              description: >-
                Machine-readable error code (e.g., "invalid_argument",
                "not_found", "permission_denied", "rate_limited").
            message:
              type: string
              description: Human-readable error description explaining what went wrong.
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-manus-api-key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.