project.create

Creates a new project. Projects let you group related tasks and apply shared instructions. Pass the returned ID as project_id in task.create to create tasks within this project.

POST /v2/project.create

CreateProject

cURL

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

200

{
  "ok": true,
  "request_id": "<string>",
  "project": {
    "id": "<string>",
    "name": "<string>",
    "created_at": 123,
    "instruction": "<string>"
  }
}

^{Questions or issues? Contact us at [e-mail].}

OAuth scope: create_project or manage_all_tasks — see the OAuth2 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 OAuth2 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

200

application/json

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.

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.