Skip to main content
POST
/
v1
/
projects
CreateProject
curl --request POST \
  --url https://api.manus.ai/v1/projects \
  --header 'API_KEY: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "instruction": "<string>"
}
'
{
  "id": "<string>",
  "name": "<string>",
  "instruction": "<string>",
  "created_at": 123
}
Create a new project to organize tasks and apply consistent instructions across multiple tasks.

​
Request Body

FieldTypeRequiredDescription
namestringYesThe name of the project
instructionstringNoDefault instruction that will be applied to all tasks in this project

​
Example Request

curl -X POST "https://api.manus.ai/v1/projects" \
  -H "Content-Type: application/json" \
  -H "API_KEY: your-api-key" \
  -d '{
    "name": "Research Project",
    "instruction": "You must start every response with a summary of key findings"
  }'

​
Example Response

{
  "id": "proj_abc123",
  "name": "Research Project",
  "instruction": "You must start every response with a summary of key findings",
  "created_at": 1699900000
}

​
Using Projects with Tasks

Once you’ve created a project, you can assign tasks to it by including the project_id in your task creation request: 
curl -X POST "https://api.manus.ai/v1/tasks" \
  -H "Content-Type: application/json" \
  -H "API_KEY: your-api-key" \
  -d '{
    "prompt": "Analyze this data",
    "agent_profile": "manus-1.5",
    "project_id": "proj_abc123"
  }'
The project’s instruction will be automatically applied to all tasks created within that project.

Authorizations

​
API_KEY
string
header
required

Body

application/json
​
name
string
required

Name of the project

​
instruction
string

Default instruction that will be applied to all tasks in this project

Response

200 - application/json

Project created successfully.

​
id
string

Unique identifier for the project

​
name
string

Name of the project

​
instruction
string

Default instruction applied to all tasks in this project

​
created_at
integer<int64>

Unix timestamp (seconds) when the project was created