Create Project

Creates a new project to organize tasks and apply consistent instructions.

POST /v1/projects

CreateProject

cURL

curl --request POST \
  --url https://api.manus.ai/v1/projects \
  --header 'API_KEY: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>"
}
'

200

{
  "id": "<string>",
  "name": "<string>",
  "instruction": "<string>",
  "created_at": 123
}

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

Field	Type	Required	Description
name	string	Yes	The name of the project
instruction	string	No	Default 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