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>"
}
'
{
  "id": "<string>",
  "name": "<string>",
  "instruction": "<string>",
  "created_at": 123
}

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.

API v1 is deprecated and will be removed in the future. Please migrate to API v2 for new features and long-term support.
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.6",
    "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