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": "Write a function to calculate fibonacci numbers",
  "agentProfile": "manus-1.5"
}
'
{
  "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
required

The task prompt or instruction for the Manus agent.

Example:

"Write a function to calculate fibonacci numbers"

​
agentProfile
enum<string>
default:manus-1.5
required

manus-1.5, manus-1.5-lite, speed (deprecated, use manus-1.5-lite), or quality (deprecated, use manus-1.5)

Available options:
manus-1.5,
manus-1.5-lite,
speed,
quality
​
attachments
(File ID Attachment · object | URL Attachment · object | Base64 Data Attachment · object)[]

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

​
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)

​
locale
string

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

​
projectId
string

ID of the project to associate this task with. The project's instruction will be applied to the task.

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.