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). Note: message.connectors behaves differently here than in task.create — a non-empty list overrides the task's connectors, while omitting it (or passing an empty array) reuses the connectors configured at task.create time rather than re-resolving project/user defaults. To remove all connectors, use the top-level clear_connectors field instead.

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

agent_profile

Agent profile override for this turn and subsequent turns. Use the stable values standard, 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 keep the task's current profile; 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

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

Removes all connectors from this task for this and subsequent turns. Combine with message.connectors to form three states: a non-empty message.connectors overrides the task's connectors with the new list; clear_connectors: true clears all connectors; omitting both reuses the connectors configured at task.create time. Passing a non-empty message.connectors together with clear_connectors: true is a conflict and returns InvalidArgument.

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.

⌘I

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