project.update

POST

project.update

UpdateProject

curl --request POST \
  --url https://api.manus.ai/v2/project.update \
  --header 'Content-Type: application/json' \
  --data '
{
  "project_id": "<string>"
}
'

import requests

url = "https://api.manus.ai/v2/project.update"

payload = { "project_id": "<string>" }
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({project_id: '<string>'})
};

fetch('https://api.manus.ai/v2/project.update', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.manus.ai/v2/project.update",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'project_id' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.manus.ai/v2/project.update"

	payload := strings.NewReader("{\n  \"project_id\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.manus.ai/v2/project.update")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"project_id\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "ok": true,
  "request_id": "<string>",
  "project": {
    "id": "<string>",
    "name": "<string>",
    "created_at": 123,
    "instruction": "<string>",
    "connector_ids": [
      "<string>"
    ],
    "skill_ids": [
      "<string>"
    ],
    "updated_at": 123
  }
}

{
  "ok": false,
  "request_id": "<string>",
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

^{Questions or issues? Contact us at api-support@manus.ai.}

Auth:

API Key: Full access.
Standard OAuth client: Requires manage_all_tasks. create_project alone is not sufficient.
Trusted client: Full access.

The user must own the project or be a project member with edit permission.

Update rules

Send project_id and at least one of name, instruction, connector_ids, or skill_ids. Omitted fields keep their current values.
An empty string clears instruction. name cannot be cleared.
connector_ids and skill_ids replace the entire list rather than adding to it. Pass [] to clear a list. To add or remove one item, read the current list with project.detail and send the full new list.
The response contains the full updated configuration in the same shape as project.detail.

Errors

Status	Cause
`400 invalid_argument`	`project_id` is missing; no updatable field is present; `name` is blank or longer than 255 characters; `instruction` exceeds 65,535 UTF-8 bytes; `connector_ids` has more than 500 entries or `skill_ids` more than 50; a list entry is not a non-empty string of at most 128 bytes; or a connector ID does not exist.
`400 failed_precondition`	A connector is not installed or authorized in the user’s account, or a Skill Hub skill has no available version.
`403 permission_denied`	The user can view the project but cannot edit it; a Standard OAuth client lacks `manage_all_tasks`; or a connector was not granted to the app.
`404 not_found`	The project does not exist or the user is not a member, or a skill ID is unknown or cannot be used as a project default skill.
`429 rate_limited`	The `project.update` limit was exceeded; see Rate Limits.

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. An OAuth client requires the manage_all_tasks scope unless it is a Trusted team client or Trusted public client; create_project alone is not sufficient. Provide either this or x-manus-api-key, not both. See the Open App guide.

Example:

"Bearer {access_token}"

Body

application/json

project_id

string

required

The unique identifier of the project to update. Use project.list to get project IDs.

name

string

New display name, 1–255 characters. Cannot be empty or whitespace only.

Required string length: 1 - 255

instruction

string

New default instruction applied to tasks in this project, up to 65,535 UTF-8 bytes. Pass an empty string to clear it.

connector_ids

string[]

Replaces the project's default connectors with this list. Pass [] to remove all default connectors; omit the field to keep them unchanged. Accepts up to 500 connector IDs from connector.list; duplicates are ignored. Each connector must be installed and authorized in the user's account. A Standard OAuth client can set only connectors the user granted to the app, and the My Browser connector also requires the use_my_browsers scope.

Maximum array length: 500

skill_ids

string[]

Replaces the project's default skills with this list. Pass [] to remove all default skills; omit the field to keep them unchanged. Accepts up to 50 skill IDs from skill.list; duplicates are ignored. Each skill must be an official skill, a Skill Hub skill, a skill of the user's team, or a skill of this project; other skills, including personal and Open App skills, return 404 not_found. Project members' individual skill preferences are kept.

Maximum array length: 50

Response

Project updated successfully.

boolean

Whether the request was successful.

Example:

true

request_id

string

Unique identifier for this API request.

project

object

The updated project with its full configuration.

Hide child attributes

project.id

string

Unique identifier for the project.

project.name

string

Display name of the project.

project.created_at

integer<int64>

Unix timestamp (seconds) when the project was created.

project.instruction

string

Default instruction applied to all tasks in this project. Omitted when the project has no instruction.

project.connector_ids

string[]

IDs of the project's default connectors. Tasks in this project use them when message.connectors is omitted; see task.create. Omitted when the project has no default connectors.

project.skill_ids

string[]

IDs of the project's default skills. Omitted when the project has no default skills.

project.updated_at

integer<int64>

Unix timestamp (seconds) when the project configuration was last updated.

UpdateProject

curl --request POST \
  --url https://api.manus.ai/v2/project.update \
  --header 'Content-Type: application/json' \
  --data '
{
  "project_id": "<string>"
}
'

import requests

url = "https://api.manus.ai/v2/project.update"

payload = { "project_id": "<string>" }
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({project_id: '<string>'})
};

fetch('https://api.manus.ai/v2/project.update', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.manus.ai/v2/project.update",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'project_id' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.manus.ai/v2/project.update"

	payload := strings.NewReader("{\n  \"project_id\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.manus.ai/v2/project.update")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"project_id\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "ok": true,
  "request_id": "<string>",
  "project": {
    "id": "<string>",
    "name": "<string>",
    "created_at": 123,
    "instruction": "<string>",
    "connector_ids": [
      "<string>"
    ],
    "skill_ids": [
      "<string>"
    ],
    "updated_at": 123
  }
}

{
  "ok": false,
  "request_id": "<string>",
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

Getting Started

API Reference

Update rules

Errors

Headers

Body

Response

​Update rules

​Errors

Headers

Body

Response

Update rules

Errors