task.sendMessage

POST

task.sendMessage

SendMessage

curl --request POST \
  --url https://api.manus.ai/v2/task.sendMessage \
  --header 'Content-Type: application/json' \
  --data '
{
  "task_id": "<string>",
  "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.sendMessage"

payload = {
    "task_id": "<string>",
    "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({
    task_id: '<string>',
    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.sendMessage', 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.sendMessage",
  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([
    'task_id' => '<string>',
    '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.sendMessage"

	payload := strings.NewReader("{\n  \"task_id\": \"<string>\",\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.sendMessage")
  .header("Content-Type", "application/json")
  .body("{\n  \"task_id\": \"<string>\",\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.sendMessage")

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  \"task_id\": \"<string>\",\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>"
}

{
  "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, only tasks created by the same client; see Task visibility.
Trusted client: Full access.

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

task_id

string

required

The unique identifier of the task to send the message to. Supports the shortcut agent-default-main_task for the IM agent's main task.

message

object

required

The follow-up message. Supports the same content formats as task.create (plain text or multi-part with files). A non-empty message.connectors replaces the task's connector selection; omitting it or passing an empty array keeps the task's current selection. To clear the selection, use the top-level clear_connectors field.

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[]

Connector IDs for this task. A non-empty list replaces the task's connector selection. An empty array is treated the same as omitting the field. When omitted:

On task.create with project_id, the task uses the project's default connectors.
On task.create without project_id, the task uses the connectors you enabled by default in your account. Connectors that are installed but not enabled are not loaded.
On task.sendMessage, the task keeps its current selection.

To start or continue without connectors, set the top-level clear_connectors: true. Use connector.list to get connector IDs.

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}$

agent_profile

Agent profile override for this turn and subsequent turns. Use the stable values standard, lite, or max, or a Max thinking level: max-medium, max-high, max-extra, or max-ultra. The thinking level also applies to subsequent turns; plain max keeps the level the task already uses; a task that has never selected a level uses the default, currently equivalent to max-extra. Versioned aliases such as 1.6-lite, 2.0-max, 2.0-max-ultra, 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 keep the task's current profile and thinking level; unlike task.create, this endpoint does not default to standard. Free personal accounts are downgraded to lite when an override is provided.

Available options:

standard,

lite,

max,

max-medium,

max-high,

max-extra,

max-ultra

structured_output_schema

object

JSON Schema for structured output extraction, armed for the next time this task finishes (stop_reason: finish).

A new schema replaces any previous one.
Omitted — the current schema state is unchanged; an armed schema is not cleared.

See the Structured Output guide.

clear_connectors

boolean

default:false

Clears the task's connector selection for this and subsequent turns. Cannot be combined with a non-empty message.connectors. Other task features may still provide tools. See the Connectors guide.

Response

Message sent successfully. The task will resume processing.

boolean

Whether the request was successful.

Example:

true

request_id

string

Unique identifier for this API request.

task_id

string

The ID of the task the message was sent to.

SendMessage

curl --request POST \
  --url https://api.manus.ai/v2/task.sendMessage \
  --header 'Content-Type: application/json' \
  --data '
{
  "task_id": "<string>",
  "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.sendMessage"

payload = {
    "task_id": "<string>",
    "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({
    task_id: '<string>',
    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.sendMessage', 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.sendMessage",
  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([
    'task_id' => '<string>',
    '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.sendMessage"

	payload := strings.NewReader("{\n  \"task_id\": \"<string>\",\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.sendMessage")
  .header("Content-Type", "application/json")
  .body("{\n  \"task_id\": \"<string>\",\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.sendMessage")

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  \"task_id\": \"<string>\",\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>"
}

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

Getting Started

API Reference

Headers

Body

Response