Agents
agent.detail
Retrieves an agent’s details including its nickname, description, and associated task. Use agent.update to modify, or task.list with scope=agent_subtask to view this agent’s subtasks.
GET
/
v2
/
agent.detail
cURL
curl --request GET \
--url 'https://api.manus.ai/v2/agent.detail?agent_id=<string>' \
--header 'x-manus-api-key: <api-key>'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)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
$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>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}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))
}HttpResponse<String> response = Unirest.get("https://api.manus.ai/v2/agent.detail?agent_id=<string>")
.header("x-manus-api-key", "<api-key>")
.asString();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{
"ok": true,
"request_id": "<string>",
"agent": {
"id": "<string>",
"task_id": "<string>",
"nickname": "<string>",
"about": "<string>"
}
}{
"ok": false,
"request_id": "<string>",
"error": {
"code": "<string>",
"message": "<string>"
}
}Questions or issues? Contact us at api-support@manus.ai.
Auth: API Key or Trusted client. Standard OAuth clients cannot access this endpoint.
Headers
API key for direct authentication. Provide either this or Authorization, not both. See Authentication.
Query Parameters
The unique identifier of the agent to retrieve.
Response
Agent retrieved successfully.
Whether the request was successful.
Example:
true
Unique identifier for this API request.
The agent object with full details.
Hide child attributes
Hide child attributes
The agent's main task, which is its persistent conversation thread. Pass it as task_id to task.sendMessage to talk to the agent, or to task.listMessages to read the conversation. For the IM agent, the shortcut agent-default-main_task resolves to this value.
Display name of the agent. Can be updated via agent.update.
Description or bio of the agent explaining its purpose and specialization. Can be updated via agent.update.
Was this page helpful?
⌘I
cURL
curl --request GET \
--url 'https://api.manus.ai/v2/agent.detail?agent_id=<string>' \
--header 'x-manus-api-key: <api-key>'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)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
$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>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}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))
}HttpResponse<String> response = Unirest.get("https://api.manus.ai/v2/agent.detail?agent_id=<string>")
.header("x-manus-api-key", "<api-key>")
.asString();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{
"ok": true,
"request_id": "<string>",
"agent": {
"id": "<string>",
"task_id": "<string>",
"nickname": "<string>",
"about": "<string>"
}
}{
"ok": false,
"request_id": "<string>",
"error": {
"code": "<string>",
"message": "<string>"
}
}