Manus API

https://open.manus.ai/docs
Admin
Manus API is an integration API that allows developers to seamlessly integrate Manus as a complete...
Tokens:49,763
Snippets:363
Trust Score:8.2
Update:2 months ago
Show doc for...
Tokens:
Raw
### Create Task Request Examples

Source: https://open.manus.ai/docs/v2/create-task

Examples of how to send a POST request to the task.create endpoint using various programming languages.

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

```python
import requests

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

payload = { "message": {
        "content": [
            {
                "type": "text",
                "text": "<string>"
            }
        ],
        "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)
```

```javascript
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    message: {
      content: [{type: 'text', text: '<string>'}],
      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
<?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>'
                ]
        ],
        '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;
}
```

```go
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      }\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))

}
```

```java
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      }\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();
```

```ruby
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      }\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
```

--------------------------------

### Create Webhook Request Examples

Source: https://open.manus.ai/docs/v2/create-webhook

Examples of how to call the webhook.create endpoint using various programming languages and tools.

```curl
curl --request POST \
  --url https://api.manus.ai/v2/webhook.create \
  --header 'Content-Type: application/json' \
  --header 'x-manus-api-key: <x-manus-api-key>' \
  --data '
{
  "url": "<string>"
}
'
```

```python
import requests

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

payload = { "url": "<string>" }
headers = {
    "x-manus-api-key": "<x-manus-api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)
```

```javascript
const options = {
  method: 'POST',
  headers: {'x-manus-api-key': '<x-manus-api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({url: '<string>'})
};

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

```php
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.manus.ai/v2/webhook.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([
    'url' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-manus-api-key: <x-manus-api-key>"
  ],
]);

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

curl_close($curl);

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

```go
package main

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

func main() {

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

	payload := strings.NewReader("{\n  \"url\": \"<string>\"\n}")

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

	req.Header.Add("x-manus-api-key", "<x-manus-api-key>")
	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))

}
```

```java
HttpResponse<String> response = Unirest.post("https://api.manus.ai/v2/webhook.create")
  .header("x-manus-api-key", "<x-manus-api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"url\": \"<string>\"\n}")
  .asString();
```

```ruby
require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Post.new(url)
request["x-manus-api-key"] = '<x-manus-api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"url\": \"<string>\"\n}"

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

--------------------------------

### Upload File Request Examples

Source: https://open.manus.ai/docs/v2/upload-file

Examples of how to initiate a file upload request across various programming languages.

```curl
curl --request POST \
  --url https://api.manus.ai/v2/file.upload \
  --header 'Content-Type: application/json' \
  --data '
{
  "filename": "<string>"
}
'
```

```python
import requests

url = "https://api.manus.ai/v2/file.upload"

payload = { "filename": "<string>" }
headers = {"Content-Type": "application/json"}

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

print(response.text)
```

```javascript
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({filename: '<string>'})
};

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

```php
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.manus.ai/v2/file.upload",
  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([
    'filename' => '<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;
}
```

```go
package main

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

func main() {

	url := "https://api.manus.ai/v2/file.upload"

	payload := strings.NewReader("{\n  \"filename\": \"<string>\"\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))

}
```

```java
HttpResponse<String> response = Unirest.post("https://api.manus.ai/v2/file.upload")
  .header("Content-Type", "application/json")
  .body("{\n  \"filename\": \"<string>\"\n}")
  .asString();
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.manus.ai/v2/file.upload")

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  \"filename\": \"<string>\"\n}"

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

--------------------------------

### Install Manus API Skill

Source: https://open.manus.ai/docs/v2/manus-api-skill

Use the Skills CLI to detect supported agents and install the skill. The first command prompts for selection, while the second performs a non-interactive global installation for Codex.

```bash
npx skills add https://open.manus.ai/docs
```

```bash
npx skills add https://open.manus.ai/docs --skill manus-api --agent codex --global --yes
```

--------------------------------

### GET /v2/connector.list

Source: https://open.manus.ai/docs/v2/connector.list

Lists all connectors installed in the current user's account. The returned connector IDs are required for task creation and messaging operations.

```APIDOC
## GET /v2/connector.list

### Description
Lists connectors installed in the current user's account. Use the returned IDs in the `connectors` array of task.create or task.sendMessage.

### Method
GET

### Endpoint
/v2/connector.list

### Parameters
#### Header Parameters
- **x-manus-api-key** (string) - Optional - API key for direct authentication. Provide either this or Authorization, not both.
- **Authorization** (string) - Optional - OAuth2 access token in `Bearer {token}` format. Provide either this or x-manus-api-key, not both.

### Response
#### Success Response (200)
- **ok** (boolean) - Whether the request was successful.
- **request_id** (string) - Unique identifier for this API request.
- **data** (array) - Array of connectors installed in the user's account.

#### Response Example
{
  "ok": true,
  "request_id": "req_12345",
  "data": [
    {
      "id": "conn_abc",
      "name": "Google Drive",
      "type": "builtin",
      "description": "Access your files",
      "category": "productivity"
    }
  ]
}
```

--------------------------------

### Signature format example

Source: https://open.manus.ai/docs/v2/webhooks-security

A concrete example of the concatenated string used for signature verification.

```text
1704067200.https://api.yourapp.com/webhooks.a1b2c3d4e5f6...
```

--------------------------------

### Define Schema Keywords

Source: https://open.manus.ai/docs/v2/structured-output

Examples of schema keywords for validation and documentation.

```json
{ "type": "string", "enum": ["low", "medium", "high"] }
```

```json
{ "type": "string", "description": "ISO 8601 date" }
```

```json
{ "anyOf": [{ "type": "string" }, { "type": "null" }] }
```

```json
{ "type": ["string", "null"] }
```

--------------------------------

### Create Project API Requests

Source: https://open.manus.ai/docs/v2/create-project

Examples of how to call the project.create endpoint using various programming languages.

```curl
curl --request POST \
  --url https://api.manus.ai/v2/project.create \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>"
}
'
```

```python
import requests

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

payload = { "name": "<string>" }
headers = {"Content-Type": "application/json"}

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

print(response.text)
```

```javascript
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({name: '<string>'})
};

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

```php
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.manus.ai/v2/project.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([
    'name' => '<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;
}
```

```go
package main

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

func main() {

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

	payload := strings.NewReader("{\n  \"name\": \"<string>\"\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))

}
```

```java
HttpResponse<String> response = Unirest.post("https://api.manus.ai/v2/project.create")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\"\n}")
  .asString();
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.manus.ai/v2/project.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  \"name\": \"<string>\"\n}"

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

--------------------------------

### List Skills API Requests

Source: https://open.manus.ai/docs/v2/list-skills

Examples of how to call the v2/skill.list endpoint using various programming languages.

```curl
curl --request GET \
  --url https://api.manus.ai/v2/skill.list
```

```python
import requests

url = "https://api.manus.ai/v2/skill.list"

response = requests.get(url)

print(response.text)
```

```javascript
const options = {method: 'GET'};

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

```php
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.manus.ai/v2/skill.list",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

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

curl_close($curl);

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

```go
package main

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

func main() {

	url := "https://api.manus.ai/v2/skill.list"

	req, _ := http.NewRequest("GET", url, nil)

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

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

	fmt.Println(string(body))

}
```

```java
HttpResponse<String> response = Unirest.get("https://api.manus.ai/v2/skill.list")
  .asString();
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.manus.ai/v2/skill.list")

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

request = Net::HTTP::Get.new(url)

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

--------------------------------

### GET /v2/project.list

Source: https://open.manus.ai/docs/v2/project.list

Lists all projects. Use the returned IDs as project_id in task.create or task.list.

```APIDOC
## GET /v2/project.list

### Description
Lists all projects. Use the returned IDs as `project_id` in task.create or task.list.

### Method
GET

### Endpoint
/v2/project.list

### Parameters
#### Header Parameters
- **x-manus-api-key** (string) - Optional - API key for direct authentication. Provide either this or `Authorization`, not both.
- **Authorization** (string) - Optional - OAuth2 access token in `Bearer {token}` format. Provide either this or `x-manus-api-key`, not both.

### Response
#### Success Response (200)
- **ok** (boolean) - Whether the request was successful.
- **request_id** (string) - Unique identifier for this API request.
- **data** (array) - Array of project objects.

#### Response Example
{
  "ok": true,
  "request_id": "...",
  "data": [
    {
      "id": "string",
      "name": "string",
      "created_at": 0,
      "instruction": "string"
    }
  ]
}
```

--------------------------------

### List Agents API Requests

Source: https://open.manus.ai/docs/v2/list-agents

Examples of how to call the agent.list endpoint using various programming languages and tools.

```curl
curl --request GET \
  --url https://api.manus.ai/v2/agent.list \
  --header 'x-manus-api-key: <x-manus-api-key>'
```

```python
import requests

url = "https://api.manus.ai/v2/agent.list"

headers = {"x-manus-api-key": "<x-manus-api-key>"}

response = requests.get(url, headers=headers)

print(response.text)
```

```javascript
const options = {method: 'GET', headers: {'x-manus-api-key': '<x-manus-api-key>'}};

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

```php
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.manus.ai/v2/agent.list",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-manus-api-key: <x-manus-api-key>"
  ],
]);

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

curl_close($curl);

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

```go
package main

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

func main() {

	url := "https://api.manus.ai/v2/agent.list"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-manus-api-key", "<x-manus-api-key>")

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

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

	fmt.Println(string(body))

}
```

```java
HttpResponse<String> response = Unirest.get("https://api.manus.ai/v2/agent.list")
  .header("x-manus-api-key", "<x-manus-api-key>")
  .asString();
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.manus.ai/v2/agent.list")

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

request = Net::HTTP::Get.new(url)
request["x-manus-api-key"] = '<x-manus-api-key>'

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

--------------------------------

### Retrieve Agent Details via API

Source: https://open.manus.ai/docs/v2/agent.update

Examples for fetching agent information using different programming languages. Requires an API key passed in the header.

```bash
curl --request GET \
  --url 'https://api.manus.ai/v2/agent.detail?agent_id=<string>' \
  --header 'x-manus-api-key: <api-key>'
```

```python
import requests


url = "https://api.manus.ai/v2/agent.detail"


headers = {
    "x-manus-api-key": "<api-key>"
}


response = requests.get(url, headers=headers, params={"agent_id":
"<string>"})


print(response.text)
```

```javascript
const options = {
  method: 'GET',
  headers: {'x-manus-api-key': '<api-key>'}
};


fetch('https://api.manus.ai/v2/agent.detail?agent_id=<string>',
options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
```

```php
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.manus.ai/v2/agent.detail?agent_id=<string>",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-manus-api-key: <api-key>"
  ],
]);
```

--------------------------------

### GET /v2/webhook.list

Source: https://open.manus.ai/docs/v2/webhook.publicKey

Lists all webhooks in your account. This endpoint requires an API key for authentication.

```APIDOC
## GET /v2/webhook.list

### Description
Lists all webhooks in your account. Use the returned IDs to remove a webhook.

### Method
GET

### Endpoint
/v2/webhook.list

### Parameters
#### Header Parameters
- **x-manus-api-key** (string) - Required - API key for authentication. This endpoint does not support OAuth2 tokens.

### Response
#### Success Response (200)
- **ok** (boolean) - Whether the request was successful.
- **request_id** (string) - Unique identifier for this API request.
- **data** (array) - Array of webhook objects.

#### Response Example
{
  "ok": true,
  "request_id": "...",
  "data": [
    {
      "id": "string",
      "url": "string",
      "status": "active | inactive",
      "created_at": "integer"
    }
  ]
}
```

--------------------------------

### connector.list

Source: https://open.manus.ai/docs/v2/connector.list

Lists all connectors installed in the current user's account. The returned IDs are required for task creation and messaging operations.

```APIDOC
## connector.list

### Description
Lists connectors installed in the current user's account. Use the returned IDs in the `connectors` array of `task.create` or `task.sendMessage`.

### OAuth Scopes
- `create_task`
- `manage_all_tasks`

### Notes
With OAuth, this method only returns connectors that the user has granted to the application.
```

--------------------------------

### GET /v2/browser.onlineList

Source: https://open.manus.ai/docs/v2/task-lifecycle

Retrieves a list of available local browser clients that can be connected to the agent.

```APIDOC
## GET /v2/browser.onlineList

### Description
Retrieves a list of available local browser clients that can be connected to the agent.

### Method
GET

### Endpoint
https://api.manus.ai/v2/browser.onlineList

### Request Example
curl 'https://api.manus.ai/v2/browser.onlineList' \
  -H 'x-manus-api-key: YOUR_API_KEY'
```

--------------------------------

### GET https://api.manus.ai/v2/skill.list

Source: https://open.manus.ai/docs/v2/list-skills

Retrieves a list of all skills available to the user.

```APIDOC
## GET https://api.manus.ai/v2/skill.list

### Description
Retrieves a list of all skills available to the user. This includes system-wide official skills as well as user, team, or project-specific skills.

### Method
GET

### Endpoint
https://api.manus.ai/v2/skill.list

### Response
#### Success Response (200)
- **ok** (boolean) - Whether the request was successful.
- **request_id** (string) - Unique identifier for this API request.
- **data** (object[]) - Array of skill objects.
  - **id** (string) - Unique identifier for the skill.
  - **name** (string) - Display name of the skill.
  - **description** (string) - What the skill does and when it's useful.
  - **owner_type** (enum) - Who owns the skill (personal, official, team, project).
  - **creator_info** (object) - Information about who created the skill.
    - **user_id** (string) - User ID of the skill creator.
    - **name** (string) - Display name of the skill creator.
  - **created_at** (integer) - Unix timestamp (seconds) when the skill was created.
  - **updated_at** (integer) - Unix timestamp (seconds) when the skill was last updated.

#### Response Example
{
  "ok": true,
  "request_id": "<string>",
  "data": [
    {
      "id": "<string>",
      "name": "<string>",
      "description": "<string>",
      "creator_info": {
        "user_id": "<string>",
        "name": "<string>"
      },
      "created_at": 123,
      "updated_at": 123
    }
  ]
}
```

--------------------------------

### Slack Integration Webhook Handler

Source: https://open.manus.ai/docs/v2/webhooks-overview

A Node.js/Express example for posting task completion messages to a Slack channel.

```javascript
// Example webhook handler for Slack integration
app.post('/manus-webhook', (req, res) => {
  const { event_type, task_detail } = req.body;
  const { task_title, message, stop_reason } = task_detail || {};

  if (event_type === 'task_stopped' && stop_reason === 'finish') {
    // Post completion message to Slack
    slack.chat.postMessage({
      channel: '#ai-tasks',
      text: `✅ Task completed: ${task_title}\n${message}`
    });
  }

  res.status(200).send('OK');
});
```

--------------------------------

### Retrieve Agent Details via API

Source: https://open.manus.ai/docs/v2/agent.update

Examples for fetching agent details using various programming languages. Ensure the x-manus-api-key header is set with your valid API key.

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

            curl_close($curl);

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

```go
package main

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

func main() {

	url := "https://api.manus.ai/v2/agent.detail?agent_id=<string>"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-manus-api-key", "<api-key>")

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

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

	fmt.Println(string(body))

}
```

```java
HttpResponse<String> response =
            Unirest.get("https://api.manus.ai/v2/agent.detail?agent_id=<string>")
              .header("x-manus-api-key", "<api-key>")
              .asString();
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.manus.ai/v2/agent.detail?agent_id=<string>")

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

request = Net::HTTP::Get.new(url)
request["x-manus-api-key"] = '<api-key>'

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

--------------------------------

### GET /v2/skill.list

Source: https://open.manus.ai/docs/v2/list-skills

Lists available skills. Includes project skills when project_id is provided. Use the returned IDs in enable_skills or force_skills of task.create.

```APIDOC
## GET /v2/skill.list

### Description
Lists available skills. Includes project skills when project_id is provided. Use the returned IDs in `enable_skills` or `force_skills` of task.create.

### Method
GET

### Endpoint
/v2/skill.list

### Parameters
#### Query Parameters
- **project_id** (string) - Optional - When provided, includes project-specific skills in addition to the user's global skills.

### Response
#### Success Response (200)
- **ok** (boolean) - Status of the request
- **request_id** (string) - Unique identifier for the request
- **data** (array) - List of skills

#### Response Example
{
  "ok": true,
  "request_id": "<string>",
  "data": [
    {
      "id": "<string>",
      "name": "<string>",
      "description": "<string>",
      "creator_info": {
        "user_id": "<string>",
        "name": "<string>"
      },
      "created_at": 123,
      "updated_at": 123
    }
  ]
}
```

--------------------------------

### OpenAPI Specification for skill.list

Source: https://open.manus.ai/docs/v2/skill.list

Defines the GET /v2/skill.list endpoint, including authentication headers and the structure of the returned skill objects.

```yaml
openapi: 3.1.0
info:
  title: Manus OpenAPI v2
  description: >-
    API for integrating Manus into your workflow. All responses are wrapped with
    {"ok": true, "request_id": "...", ...} for success and {"ok": false,
    "request_id": "...", "error": {"code": "...", "message": "..."}} for errors.
  version: 2.0.0
servers:
  - url: https://api.manus.ai
security:
  - ApiKeyAuth: []
paths:
  /v2/skill.list:
    get:
      summary: ListSkills
      description: >-
        Lists available skills. Includes project skills when project_id is
        provided. Use the returned IDs in `enable_skills` or `force_skills` of
        [task.create](https://open.manus.ai/docs/v2/task.create).
      operationId: openapi.v2.OpenapiV2Service.ListSkills
      parameters:
        - name: x-manus-api-key
          in: header
          required: false
          schema:
            type: string
          description: >-
            API key for direct authentication. Provide either this or
            `Authorization`, not both. See
            [Authentication](https://open.manus.ai/docs/v2/authentication).
        - name: Authorization
          in: header
          required: false
          schema:
            type: string
            example: Bearer {access_token}
          description: >-
            OAuth2 access token in `Bearer {token}` format. Provide either this
            or `x-manus-api-key`, not both. See the [Open
            App](https://open.manus.ai/docs/v2/open-app) guide.
        - name: project_id
          in: query
          schema:
            type: string
            description: >-
              When provided, includes project-specific skills in addition to the
              user's global skills. Use
              [project.list](https://open.manus.ai/docs/v2/project.list) to get
              available project IDs.
      responses:
        '200':
          description: Skills retrieved successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                    example: true
                    description: Whether the request was successful.
                  request_id:
                    type: string
                    description: Unique identifier for this API request.
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Skill'
                    description: >-
                      Array of skill objects. Use the id field when passing to
                      enable_skills or force_skills in task.create.
        4XX:
          description: Error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security: []
components:
  schemas:
    Skill:
      type: object
      description: A skill that extends the agent's capabilities.
      properties:
        id:
          type: string
          description: >-
            Unique identifier for the skill. Use this in enable_skills or
            force_skills when creating tasks.
        name:
          type: string
          description: Display name of the skill.
        description:
          type: string
          description: What the skill does and when it's useful.
        owner_type:
          type: string
          enum:
            - personal
            - official
            - team
            - project
          description: >-
            Who owns the skill. "personal" — user-created skill. "official" —
            built-in system skill. "team" — team-shared skill. "project" —
            project-specific skill.
        creator_info:
          type: object
          description: Information about who created the skill.
          properties:
            user_id:
              type: string
              description: User ID of the skill creator.
            name:
              type: string
```

--------------------------------

### Retrieve File Details via API

Source: https://open.manus.ai/docs/v2/openapi_v2.json

Examples for fetching file metadata using the file_id parameter. Ensure the file status is 'uploaded' before proceeding with task creation.

```bash
curl --request GET \
  --url 'https://api.manus.ai/v2/file.detail?file_id=<string>' \
  --header 'x-manus-api-key: <api-key>'
```

```python
import requests

url = "https://api.manus.ai/v2/file.detail"

headers = {
    "x-manus-api-key": "<api-key>"
}

response = requests.get(url, headers=headers, params={"file_id": "<string>"})

print(response.text)
```

```javascript
const options = {
  method: 'GET',
  headers: {'x-manus-api-key': '<api-key>'}
};

fetch('https://api.manus.ai/v2/file.detail?file_id=<string>', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
```

```php
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.manus.ai/v2/file.detail?file_id=<string>",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-manus-api-key: <api-key>"
  ],
]);

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

curl_close($curl);

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

```go
package main

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

func main() {

	url := "https://api.manus.ai/v2/file.detail?file_id=<string>"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-manus-api-key", "<api-key>")

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

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

	fmt.Println(string(body))

}
```

```java
HttpResponse<String> response = Unirest.get("https://api.manus.ai/v2/file.detail?file_id=<string>")
  .header("x-manus-api-key", "<api-key>")
  .asString();
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.manus.ai/v2/file.detail?file_id=<string>")

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

request = Net::HTTP::Get.new(url)
request["x-manus-api-key"] = '<api-key>'

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

--------------------------------

### Define Basic JSON Schema Types

Source: https://open.manus.ai/docs/v2/structured-output

Examples of schema definitions for various primitive data types.

```json
{ "type": "string" }
```

```json
{ "type": "number" }
```

```json
{ "type": "integer" }
```

```json
{ "type": "boolean" }
```

```json
{ "type": "null" }
```

```json
{ "type": "array", "items": { "type": "string" } }
```

--------------------------------

### GET /tasks

Source: https://open.manus.ai/docs/v2/openapi_v2.json

Retrieves a list of tasks based on the provided query parameters.

```APIDOC
## GET /tasks

### Description
Retrieves a list of tasks. Supports pagination, sorting, and filtering by scope, agent, project, or creator.

### Method
GET

### Endpoint
/tasks

### Parameters
#### Query Parameters
- **cursor** (string) - Optional - Pagination cursor from the previous response's next_cursor field. Omit for the first page.
- **order** (string) - Optional - Sort direction by creation time. "desc" (default) returns newest first, "asc" returns oldest first.
- **scope** (string) - Optional - Filter by task type. "all" (default), "standard", "project" (requires project_id), "agent_subtask" (requires agent_id).
- **agent_id** (string) - Optional - Filter tasks by agent. Required when scope="agent_subtask".
- **project_id** (string) - Optional - Filter tasks by project. Required when scope="project".
- **oauth_client_id** (string) - Optional - Filter tasks by the Open App (OAuth client) that created them. Mutually exclusive with api_key_id.
- **api_key_id** (string) - Optional - Filter tasks by the API key that created them. Mutually exclusive with oauth_client_id.

### Response
#### Success Response (200)
- **ok** (boolean) - Whether the request was successful.
- **request_id** (string) - Unique identifier for this API request.
- **data** (array) - List of tasks.
```

--------------------------------

### Retrieve Task Details

Source: https://open.manus.ai/docs/v2/openapi_v2.json

Examples for fetching task status and metadata using the /v2/task.detail endpoint. Ensure the task_id parameter is provided and the request is authenticated with an API key.

```bash
curl --request GET \
  --url 'https://api.manus.ai/v2/task.detail?task_id=<string>' \
  --header 'x-manus-api-key: <api-key>'
```

```python
import requests

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

headers = {
    "x-manus-api-key": "<api-key>"
}

response = requests.get(url, headers=headers, params={"task_id": "<string>"})

print(response.text)
```

```javascript
const options = {
  method: 'GET',
  headers: {'x-manus-api-key': '<api-key>'}
};

fetch('https://api.manus.ai/v2/task.detail?task_id=<string>', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
```

```php
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.manus.ai/v2/task.detail?task_id=<string>",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-manus-api-key: <api-key>"
  ],
]);

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

curl_close($curl);

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

```go
package main

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

func main() {

	url := "https://api.manus.ai/v2/task.detail?task_id=<string>"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-manus-api-key", "<api-key>")

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

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

	fmt.Println(string(body))

}
```

```java
HttpResponse<String> response = Unirest.get("https://api.manus.ai/v2/task.detail?task_id=<string>")
  .header("x-manus-api-key", "<api-key>")
  .asString();
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.manus.ai/v2/task.detail?task_id=<string>")

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

request = Net::HTTP::Get.new(url)
request["x-manus-api-key"] = '<api-key>'

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

--------------------------------

### GET /v2/usage.teamStatistic

Source: https://open.manus.ai/docs/v2/openapi_v2.json

Returns daily credit consumption totals for the team over a date range.

```APIDOC
## GET /v2/usage.teamStatistic

### Description
Returns daily credit consumption totals for the team over a date range.

### Method
GET

### Endpoint
/v2/usage.teamStatistic

### Parameters
#### Header Parameters
- **x-manus-api-key** (string) - Required - API key for authentication.

#### Query Parameters
- **start_date** (integer) - Optional - Filter start time as a Unix timestamp in seconds.
- **end_date** (integer) - Optional - Filter end time as a Unix timestamp in seconds.

### Response
#### Success Response (200)
- **description** (string) - Daily usage statistics retrieved successfully.
```
Tokens:
Raw