Skip to main content
POST
/
v1
/
tasks
CreateTask
curl --request POST \
  --url https://api.manus.ai/v1/tasks \
  --header 'API_KEY: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "<string>",
  "attachments": [
    {
      "filename": "<string>",
      "file_id": "<string>"
    }
  ],
  "taskMode": "chat",
  "connectors": [
    "<string>"
  ],
  "hideInTaskList": true,
  "createShareableLink": true,
  "taskId": "<string>",
  "agentProfile": "speed",
  "locale": "<string>"
}'
{
  "task_id": "<string>",
  "task_title": "<string>",
  "task_url": "<string>",
  "share_url": "<string>"
}
We support creating tasks using various connectors, click here to find out more

Authorizations

​
API_KEY
string
header
required

Body

application/json
​
prompt
string

The task prompt or instruction for the Manus agent.

​
attachments
attachments · array

Array of file/image attachments. No distinction between files and images - both are treated the same way.

  • File ID Attachment
  • URL Attachment
  • Base64 Data Attachment
​
taskMode
enum<string>

chat, adaptive or agent

Available options:
chat,
adaptive,
agent
​
connectors
string[]

List of connector IDs to enable for this task. Only connectors already configured in the user's account can be used.

​
hideInTaskList
boolean

Whether to hide this task from the Manus webapp task list. The task will still be accessible via the provided link.

​
createShareableLink
boolean

Whether to make the chat publicly accessible to others on the Manus website.

​
taskId
string

For continuing existing tasks (multi-turn)

​
agentProfile
enum<string>

speed or quality

Available options:
speed,
quality
​
locale
string

Your default locale that you've set on Manus (e.g., "en-US", "zh-CN")

Response

200 - application/json

Task created successfully.

​
task_id
string
​
task_title
string
​
task_url
string
​
share_url
string

Optional publicly accessible link to the chat. Only present if create_shareable_link was set to true.

⌘I