task.create

POST

task.create

CreateTask

curl --request POST \
  --url https://api.manus.ai/v2/task.create \
  --header 'Content-Type: application/json' \
  --data '
{
  "message": {
    "content": [
      {
        "type": "text",
        "text": "<string>",
        "visibility": "visible"
      }
    ],
    "connectors": [
      "<string>"
    ],
    "enable_skills": [
      "<string>"
    ],
    "force_skills": [
      "<string>"
    ],
    "task_references": [
      "<string>"
    ]
  }
}
'

import requests

url = "https://api.manus.ai/v2/task.create"

payload = { "message": {
        "content": [
            {
                "type": "text",
                "text": "<string>",
                "visibility": "visible"
            }
        ],
        "connectors": ["<string>"],
        "enable_skills": ["<string>"],
        "force_skills": ["<string>"],
        "task_references": ["<string>"]
    } }
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    message: {
      content: [{type: 'text', text: '<string>', visibility: 'visible'}],
      connectors: ['<string>'],
      enable_skills: ['<string>'],
      force_skills: ['<string>'],
      task_references: ['<string>']
    }
  })
};

fetch('https://api.manus.ai/v2/task.create', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.manus.ai/v2/task.create",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'message' => [
        'content' => [
                [
                                'type' => 'text',
                                'text' => '<string>',
                                'visibility' => 'visible'
                ]
        ],
        'connectors' => [
                '<string>'
        ],
        'enable_skills' => [
                '<string>'
        ],
        'force_skills' => [
                '<string>'
        ],
        'task_references' => [
                '<string>'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.manus.ai/v2/task.create"

	payload := strings.NewReader("{\n  \"message\": {\n    \"content\": [\n      {\n        \"type\": \"text\",\n        \"text\": \"<string>\",\n        \"visibility\": \"visible\"\n      }\n    ],\n    \"connectors\": [\n      \"<string>\"\n    ],\n    \"enable_skills\": [\n      \"<string>\"\n    ],\n    \"force_skills\": [\n      \"<string>\"\n    ],\n    \"task_references\": [\n      \"<string>\"\n    ]\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.manus.ai/v2/task.create")
  .header("Content-Type", "application/json")
  .body("{\n  \"message\": {\n    \"content\": [\n      {\n        \"type\": \"text\",\n        \"text\": \"<string>\",\n        \"visibility\": \"visible\"\n      }\n    ],\n    \"connectors\": [\n      \"<string>\"\n    ],\n    \"enable_skills\": [\n      \"<string>\"\n    ],\n    \"force_skills\": [\n      \"<string>\"\n    ],\n    \"task_references\": [\n      \"<string>\"\n    ]\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.manus.ai/v2/task.create")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"message\": {\n    \"content\": [\n      {\n        \"type\": \"text\",\n        \"text\": \"<string>\",\n        \"visibility\": \"visible\"\n      }\n    ],\n    \"connectors\": [\n      \"<string>\"\n    ],\n    \"enable_skills\": [\n      \"<string>\"\n    ],\n    \"force_skills\": [\n      \"<string>\"\n    ],\n    \"task_references\": [\n      \"<string>\"\n    ]\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "ok": true,
  "request_id": "<string>",
  "task_id": "<string>",
  "task_title": "<string>",
  "task_url": "<string>",
  "share_url": "<string>",
  "share_visibility": "private"
}

{
  "ok": false,
  "request_id": "<string>",
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

^{Questions or issues? Contact us at api-support@manus.ai.}

Auth:

API Key: Full access.
Standard OAuth client: Requires create_task or manage_all_tasks. With create_task, created tasks are accessible only to the same client; see Task visibility.
Trusted client: Full access.

Agents: To message an existing agent instead of creating a new task, use task.sendMessage with agent-default-main_task as task_id. See the Agents guide.

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. An OAuth client requires the create_task or manage_all_tasks scope unless it is a Trusted team client or Trusted public client. Provide either this or x-manus-api-key, not both. See the Open App guide.

Example:

"Bearer {access_token}"

Body

application/json

message

object

required

The message to start the task with. Contains the prompt text, optional file attachments, and connector/skill configuration.

Hide child attributes

message.content

required

String (plain text) or array of ContentPart objects. User text is limited to approximately 5,000 estimated tokens per request; the exact character count varies by language and content. For an array, the limit applies to the combined text of all text parts; file parts do not count. Input over the limit returns InvalidArgument (HTTP 400). Each message must contain at least one non-empty visible text part or valid visible file/voice part.

Text
File
Voice

Hide child attributes

message.content.type

enum<string>

required

Must be "text".

Available options:

text

message.content.text

string

required

The text content of the message. Across a ContentPart array, all text parts must contain no more than approximately 5,000 estimated tokens in total.

message.content.visibility

enum<string>

default:visible

Optional. Most integrations can omit this field. A Trusted public client can set it to hidden to pass additional application context without displaying it to users. See Hidden application context.

Available options:

visible,

hidden

message.connectors

string[]

List of connector IDs to enable for this task. Resolution order when omitted: 1) if the task belongs to a project, the project's default connectors are used; 2) otherwise, the user's default enabled connectors are used. Use connector.list to get the connectors installed in your account.

message.enable_skills

string[]

Skill IDs to enable for this task. Use skill.list to retrieve available skill IDs. An empty list is treated the same as omitting this field.

API Key: The user's enabled skills are loaded by default.
Standard OAuth client: All App-owned skills are loaded by default, and user skills are not loaded. When a non-empty list is supplied, only App-owned IDs are used; other IDs are silently ignored.
Trusted client: The user's enabled skills are loaded by default. The client's App skills are always added.

message.force_skills

string[]

Skill IDs the agent must invoke during this task. Forced skills are automatically available even if not listed in enable_skills. Standard OAuth clients can force only App-owned IDs; other IDs are silently ignored.

message.task_references

string[]

IDs of existing tasks the agent can browse on demand.

Bare 22-character task IDs only; up to 20 per request.
On task.sendMessage, IDs are added to the task's existing references and cannot be cleared.

See the Task references guide.

Maximum array length: 20

Pattern: ^[A-Za-z0-9]{22}$

project_id

string

Project ID to associate this task with. The project's instruction will be automatically applied. Use project.list to get available project IDs.

locale

string

Locale for the task output language (e.g., "en", "zh-CN", "ja"). Defaults to the user's account locale setting.

interactive_mode

boolean

default:false

When enabled, the agent may pause and ask follow-up questions if the input is insufficient. When disabled (default), the agent proceeds with best-effort execution without asking.

hide_in_task_list

boolean

default:false

When true, the task does not appear in the Manus webapp task list. It remains accessible through the task_url in the response.

Who can view the task.

private (default) — only the task creator.
team — all team members.
public — anyone with the share_url, without authentication.

Available options:

private,

team,

public

agent_profile

default:standard

Agent profile to use for the task. Use the stable values standard (default), lite, or max. Versioned aliases such as 1.6-lite, 2.0-max, and the legacy manus-1.6-lite form are also accepted; the version segment is ignored because model versions are not selected independently. A version without a suffix, such as 1.6 or manus-1.6, means standard. Omit the field (or pass an empty string) to use standard. Free personal accounts are downgraded to lite regardless of the requested value.

Available options:

standard,

lite,

max

title

string

Custom title for the task. If not provided, a title will be auto-generated based on the input message.

structured_output_schema

object

JSON Schema for structured output extraction. When provided, the agent runs normally, then a post-processing step extracts a result conforming to your schema. The schema must follow the Structured Output subset of JSON Schema: all object properties must be listed in required, and additionalProperties must be false. See the Structured Output guide.

Response

Task created successfully.

boolean

Whether the request was successful.

Example:

true

request_id

string

Unique identifier for this API request, useful for debugging.

task_id

string

Unique identifier for the created task. Use this to track, update, or delete the task.

task_title

string

Title for the task. Returns the custom title if one was provided in the request, otherwise an auto-generated title based on the input message.

task_url

string

URL to view the task in the Manus webapp (e.g., https://manus.im/app/{task_id}).

Publicly accessible URL for sharing. Only present when share_visibility is not "private".

The actual visibility state of the task.

Available options:

private,

team,

public

⌘I

CreateTask

curl --request POST \
  --url https://api.manus.ai/v2/task.create \
  --header 'Content-Type: application/json' \
  --data '
{
  "message": {
    "content": [
      {
        "type": "text",
        "text": "<string>",
        "visibility": "visible"
      }
    ],
    "connectors": [
      "<string>"
    ],
    "enable_skills": [
      "<string>"
    ],
    "force_skills": [
      "<string>"
    ],
    "task_references": [
      "<string>"
    ]
  }
}
'

import requests

url = "https://api.manus.ai/v2/task.create"

payload = { "message": {
        "content": [
            {
                "type": "text",
                "text": "<string>",
                "visibility": "visible"
            }
        ],
        "connectors": ["<string>"],
        "enable_skills": ["<string>"],
        "force_skills": ["<string>"],
        "task_references": ["<string>"]
    } }
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    message: {
      content: [{type: 'text', text: '<string>', visibility: 'visible'}],
      connectors: ['<string>'],
      enable_skills: ['<string>'],
      force_skills: ['<string>'],
      task_references: ['<string>']
    }
  })
};

fetch('https://api.manus.ai/v2/task.create', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.manus.ai/v2/task.create",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'message' => [
        'content' => [
                [
                                'type' => 'text',
                                'text' => '<string>',
                                'visibility' => 'visible'
                ]
        ],
        'connectors' => [
                '<string>'
        ],
        'enable_skills' => [
                '<string>'
        ],
        'force_skills' => [
                '<string>'
        ],
        'task_references' => [
                '<string>'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.manus.ai/v2/task.create"

	payload := strings.NewReader("{\n  \"message\": {\n    \"content\": [\n      {\n        \"type\": \"text\",\n        \"text\": \"<string>\",\n        \"visibility\": \"visible\"\n      }\n    ],\n    \"connectors\": [\n      \"<string>\"\n    ],\n    \"enable_skills\": [\n      \"<string>\"\n    ],\n    \"force_skills\": [\n      \"<string>\"\n    ],\n    \"task_references\": [\n      \"<string>\"\n    ]\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.manus.ai/v2/task.create")
  .header("Content-Type", "application/json")
  .body("{\n  \"message\": {\n    \"content\": [\n      {\n        \"type\": \"text\",\n        \"text\": \"<string>\",\n        \"visibility\": \"visible\"\n      }\n    ],\n    \"connectors\": [\n      \"<string>\"\n    ],\n    \"enable_skills\": [\n      \"<string>\"\n    ],\n    \"force_skills\": [\n      \"<string>\"\n    ],\n    \"task_references\": [\n      \"<string>\"\n    ]\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.manus.ai/v2/task.create")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"message\": {\n    \"content\": [\n      {\n        \"type\": \"text\",\n        \"text\": \"<string>\",\n        \"visibility\": \"visible\"\n      }\n    ],\n    \"connectors\": [\n      \"<string>\"\n    ],\n    \"enable_skills\": [\n      \"<string>\"\n    ],\n    \"force_skills\": [\n      \"<string>\"\n    ],\n    \"task_references\": [\n      \"<string>\"\n    ]\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "ok": true,
  "request_id": "<string>",
  "task_id": "<string>",
  "task_title": "<string>",
  "task_url": "<string>",
  "share_url": "<string>",
  "share_visibility": "private"
}

{
  "ok": false,
  "request_id": "<string>",
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

Getting Started

API Reference

Headers

Body

Response