Skip to main content
POST
/
v2
/
project.create
CreateProject
curl --request POST \
  --url https://api.manus.ai/v2/project.create \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>"
}
'
{
  "ok": true,
  "request_id": "<string>",
  "project": {
    "id": "<string>",
    "name": "<string>",
    "created_at": 123,
    "instruction": "<string>"
  }
}
Questions or issues? Contact us at api-support@manus.ai.
OAuth scope: create_project or manage_all_tasks — see the Open App guide.
Use in tasks: Pass the returned project ID as project_id in task.create to create tasks within this project.Instructions: The project’s instruction will be automatically applied to all tasks in the project.

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 Open App guide.

Example:

"Bearer {access_token}"

Body

application/json
​
name
string
required

Display name for the project.

​
instruction
string

Default instruction that will be automatically prepended to all tasks created within this project. Use this to enforce consistent behavior across related tasks (e.g., "Always respond in formal English" or "Focus on financial analysis").

Response

Project created successfully.

​
ok
boolean

Whether the request was successful.

Example:

true

​
request_id
string

Unique identifier for this API request.

​
project
object

The created project object.