Manus AI Agent
Delegate complex tasks to Manus - an autonomous AI agent that browses the web, writes code, generates reports, scrapes data, builds mobile apps, creates financial models, and delivers complete work products.
API Configuration
Base URL: https://api.manus.im/v1
Authentication Header: API_KEY: <your-key>
Set via:
MANUS_API_KEY environment variable- Or
skills.manus.apiKey in OpenClaw config
Agent Profiles and Pricing (Manus 1.6)
IMPORTANT: The manus-1.5, manus-1.5-lite, and manus-1.5-max profiles are DEPRECATED and will stop working. Always use the 1.6 profiles below.
| Profile | Speed | Depth | Best for | Relative cost |
|---|
manus-1.6 | Standard | Full | Most tasks, file creation, reports | Standard (recommended default) |
manus-1.6-lite | Fast | Light | Quick lookups, simple questions, summaries | ~40% cheaper |
manus-1.6-max | Slow | Deep | Complex multi-step research, thorough analysis (+19.2% satisfaction vs standard) | ~2x standard |
Default: Always use manus-1.6 unless the user explicitly asks for lite or max.
Wide Research: All Wide Research sub-agents automatically use manus-1.6-max for maximum depth.
Cost estimation guidance
Before creating a task, inform the user of the expected profile:
- Simple/quick tasks (summaries, single-page lookups): recommend
manus-1.6-lite
- Standard tasks (reports, presentations, code projects): use
manus-1.6
- Complex tasks (multi-source research, competitive analysis, deep dives): suggest
manus-1.6-max
Users can override with "use lite", "use max", or "use the cheap one" / "use the thorough one".
Manus 1.6 Capabilities
Manus 1.6 adds these capabilities over 1.5:
- Mobile development - build and preview mobile apps
- Design View - visual design and layout capabilities
- Financial modeling - spreadsheets, projections, financial analysis
- Telegram integration - interact via Telegram bot
- Built-in connectors - Gmail, Notion, Google Calendar, Slack, Similarweb
Task Modes
| Mode | Description | When to use |
|---|
agent | Full autonomous agent with tool use | File creation, web browsing, code writing (recommended default) |
chat | Conversational back-and-forth | Simple Q&A, brainstorming |
adaptive | Auto-selects best approach | When unsure which mode fits |
Default: Always use agent mode for tasks that produce deliverables.
Task Templates
Use these templates to create well-structured tasks. Always include createShareableLink: true.
Research Template
For market research, competitive analysis, topic deep-dives.
curl -s -X POST "https://api.manus.im/v1/tasks" \
-H "API_KEY: $MANUS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Research [TOPIC]. Find the top [N] [entities] by [criteria]. For each, provide: name, description, key metrics, recent news. Compile into a structured report with sections, tables, and citations. Include a summary with key takeaways.",
"agentProfile": "manus-1.6",
"taskMode": "agent",
"createShareableLink": true
}'
Example prompts:
- "Research the top 10 AI startups in healthcare by funding raised in 2025. For each provide founding year, total funding, key product, and notable customers."
- "Do a competitive analysis of project management tools: Asana, Monday, Linear, Jira, ClickUp. Compare pricing, features, integrations, and user reviews."
- "Research the current state of autonomous vehicle regulations in the US, EU, and China. Summarize key differences and recent changes."
Report Generation Template
For creating formatted documents, presentations, executive summaries.
curl -s -X POST "https://api.manus.im/v1/tasks" \
-H "API_KEY: $MANUS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Create a [FORMAT] about [TOPIC]. Include: [SECTIONS]. Use professional formatting with headers, bullet points, and data tables where appropriate. Export as [FILE_TYPE].",
"agentProfile": "manus-1.6",
"taskMode": "agent",
"createShareableLink": true
}'
Example prompts:
- "Create a 10-slide presentation about our company's AI strategy for the board meeting. Include market overview, our position, roadmap, and investment ask."
- "Write an executive summary report on the state of remote work in 2025. Include statistics, trends, and recommendations. Export as PDF."
- "Generate a one-page brief comparing AWS, GCP, and Azure for a startup choosing a cloud provider."
Code Building Template
For generating code projects, scripts, prototypes.
curl -s -X POST "https://api.manus.im/v1/tasks" \
-H "API_KEY: $MANUS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Build a [LANGUAGE/FRAMEWORK] [PROJECT_TYPE] that [FUNCTIONALITY]. Include: [REQUIREMENTS]. Follow best practices for [LANGUAGE]. Include a README with setup instructions.",
"agentProfile": "manus-1.6",
"taskMode": "agent",
"createShareableLink": true
}'
Example prompts:
- "Build a Python Flask API that takes a URL and returns a summary of the page content using BeautifulSoup for scraping. Include error handling, rate limiting, and a Dockerfile."
- "Create a React dashboard component that displays real-time metrics from a WebSocket connection. Include TypeScript types and unit tests."
- "Write a bash script that audits an AWS account for security misconfigurations: open S3 buckets, overly permissive IAM policies, unencrypted volumes."
Data Scraping Template
For extracting structured data from websites.
curl -s -X POST "https://api.manus.im/v1/tasks" \
-H "API_KEY: $MANUS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Scrape [WEBSITE/SOURCE] and extract [DATA_FIELDS] for [ENTITIES]. Output as [FORMAT: CSV/JSON/table]. Include [N] results. Handle pagination if needed.",
"agentProfile": "manus-1.6",
"taskMode": "agent",
"createShareableLink": true
}'
Example prompts:
- "Scrape the top 50 products from Product Hunt this week. Extract: name, tagline, upvote count, maker name, and URL. Output as CSV."
- "Go to news.ycombinator.com and collect the top 30 stories. Extract title, URL, points, and comment count. Output as JSON."
- "Find the top 20 open source AI projects on GitHub by stars in the last month. Extract repo name, description, stars, language, and last commit date."
Core API Operations
Create a Task
curl -s -X POST "https://api.manus.im/v1/tasks" \
-H "API_KEY: $MANUS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Your task description here",
"agentProfile": "manus-1.6",
"taskMode": "agent",
"createShareableLink": true
}'
Full parameter reference:
| Parameter | Type | Default | Description |
|---|
prompt | string | (required) | The task description |
agentProfile | string | manus-1.6 | Agent profile: manus-1.6, manus-1.6-lite, manus-1.6-max |
taskMode | string | agent | Task mode: agent, chat, adaptive |
createShareableLink | boolean | false | Generate a public share URL |
interactiveMode | boolean | false | Allow Manus to ask follow-up questions (task pauses with stop_reason: ask) |
projectId | string | - | Associate with a project's persistent instructions |
taskId | string | - | Continue an existing conversation (multi-turn) |
locale | string | - | Language locale (e.g., "zh-CN", "ja", "es") |
attachments | array | - | Files to attach (see Attachment types below) |
Attachment types:
{ "type": "fromFileId", "fileId": "file_abc123" }
{ "type": "fromUrl", "url": "https://example.com/data.csv" }
{ "type": "fromBase64", "data": "base64-encoded-content", "fileName": "image.png", "mimeType": "image/png" }
Response:
{
"task_id": "abc123",
"task_title": "Task Title",
"task_url": "https://manus.im/app/abc123",
"status": "pending"
}
After creating a task, immediately tell the user:
- The task has been submitted
- The task ID for reference
- Expected duration (2-10+ minutes depending on complexity)
- That you will monitor it for completion
Multi-Turn Conversations
To continue a previous task as a conversation, pass the original taskId:
curl -s -X POST "https://api.manus.im/v1/tasks" \
-H "API_KEY: $MANUS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Now add a section about pricing trends",
"agentProfile": "manus-1.6",
"taskMode": "agent",
"taskId": "PREVIOUS_TASK_ID",
"createShareableLink": true
}'
This preserves all context from the previous task. Use this when:
- The user says "also...", "now add...", "refine the previous..."
- A task completed with
interactiveMode and Manus asked a question (stop_reason: ask)
- The user wants to iterate on Manus output
Get Task Details
curl -s "https://api.manus.im/v1/tasks/{task_id}" \
-H "API_KEY: $MANUS_API_KEY"
Status values:
| Status | Meaning | Action |
|---|
pending | Queued, not yet started | Wait and poll again in 15-30 seconds |
running | Actively working | Wait and poll again in 15-30 seconds |
completed | Finished successfully | Retrieve and deliver results |
failed | Task errored out | Report error, suggest retry |
Update Task Metadata
curl -s -X PUT "https://api.manus.im/v1/tasks/{task_id}" \
-H "API_KEY: $MANUS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"title": "New title for this task"
}'
Delete a Task
curl -s -X DELETE "https://api.manus.im/v1/tasks/{task_id}" \
-H "API_KEY: $MANUS_API_KEY"
List Tasks (Paginated)
curl -s "https://api.manus.im/v1/tasks?status=completed&page=1&limit=20" \
-H "API_KEY: $MANUS_API_KEY"
Query parameters:
| Parameter | Type | Default | Description |
|---|
status | string | - | Filter by status: pending, running, completed, failed |
page | integer | 1 | Page number |
limit | integer | 20 | Results per page |
When showing task history to the user, format it as a table:
| Task ID | Title | Status | Profile | Created |
|---------|-------|--------|---------|---------|
| abc123 | Market Research | completed | manus-1.6 | 2 hours ago |
| def456 | Code Review | running | manus-1.6-lite | 5 min ago |
Poll for Completion
After creating a task, poll for completion. Use the helper script or curl directly.
With the helper script:
bash scripts/manus.sh wait <task_id> 600
With curl (manual polling):
task_id="YOUR_TASK_ID"
status="pending"
while [ "$status" != "completed" ] && [ "$status" != "failed" ]; do
sleep 15
status=$(curl -s "https://api.manus.im/v1/tasks/$task_id" \
-H "API_KEY: $MANUS_API_KEY" | jq -r '.status // "unknown"')
done
When polling, give the user periodic updates:
- After 30 seconds: "Still working on it..."
- After 2 minutes: "Manus is still processing. Complex tasks can take 5-10 minutes."
- After 5 minutes: "This is taking longer than usual. The task is still running."
Retrieve Results
When a task completes, the response contains output content and files:
curl -s "https://api.manus.im/v1/tasks/{task_id}" \
-H "API_KEY: $MANUS_API_KEY"
Response structure:
{
"task_id": "abc123",
"status": "completed",
"task_title": "Research Report",
"output": [
{
"content": [
{
"type": "text",
"text": "Here is the research summary..."
},
{
"type": "output_file",
"fileUrl": "https://private-us-east-1.manuscdn.com/...",
"fileName": "research_report.pdf"
}
]
}
]
}
Always do these steps when a task completes:
- Extract text content and present it to the user
- List all output files with their names
- Download files locally using curl
- Deliver files to the user directly (do not rely on manus.im share links - they can be unreliable)
Download Output Files
bash scripts/manus.sh files <task_id>
bash scripts/manus.sh download <task_id> ./manus-output
Manual download:
curl -sL "https://private-us-east-1.manuscdn.com/path/to/file" -o "output_filename.pdf"
Files API
Manage file uploads for use as task attachments.
Create a File (Get Upload URL)
curl -s -X POST "https://api.manus.im/v1/files" \
-H "API_KEY: $MANUS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"fileName": "data.csv",
"mimeType": "text/csv"
}'
Response:
{
"file_id": "file_abc123",
"upload_url": "https://s3.amazonaws.com/manus-uploads/...",
"expires_at": "2026-03-16T00:00:00Z"
}
Then upload the file content to the presigned S3 URL:
curl -s -X PUT "$UPLOAD_URL" \
-H "Content-Type: text/csv" \
--data-binary @data.csv
After uploading, use fromFileId attachment type when creating a task:
{ "attachments": [{ "type": "fromFileId", "fileId": "file_abc123" }] }
List Recent Files
curl -s "https://api.manus.im/v1/files" \
-H "API_KEY: $MANUS_API_KEY"
Returns the 10 most recent files.
Get File Details
curl -s "https://api.manus.im/v1/files/{file_id}" \
-H "API_KEY: $MANUS_API_KEY"
Delete a File
curl -s -X DELETE "https://api.manus.im/v1/files/{file_id}" \
-H "API_KEY: $MANUS_API_KEY"
Projects API
Projects let you set persistent instructions that apply to all tasks in a project. Useful for brand guidelines, output format preferences, or domain context.
Create a Project
curl -s -X POST "https://api.manus.im/v1/projects" \
-H "API_KEY: $MANUS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Q1 Market Research",
"instructions": "Always format output as markdown tables. Use formal tone. Include source URLs for all claims. Target audience: C-suite executives."
}'
Response:
{
"project_id": "proj_abc123",
"name": "Q1 Market Research"
}
Then pass projectId when creating tasks:
{ "prompt": "Research competitor pricing", "projectId": "proj_abc123" }
List Projects
curl -s "https://api.manus.im/v1/projects" \
-H "API_KEY: $MANUS_API_KEY"
Webhooks
Instead of polling, you can register a webhook URL to receive real-time task updates.
Create a Webhook
curl -s -X POST "https://api.manus.im/v1/webhooks" \
-H "API_KEY: $MANUS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://your-server.com/manus-webhook",
"events": ["task_created", "task_progress", "task_stopped"]
}'
Delete a Webhook
curl -s -X DELETE "https://api.manus.im/v1/webhooks/{webhook_id}" \
-H "API_KEY: $MANUS_API_KEY"
Webhook Event Types
task_created - Fires when a task starts:
{
"event": "task_created",
"task_id": "abc123",
"title": "Market Research Report",
"url": "https://manus.im/app/abc123"
}
task_progress - Fires during task execution:
{
"event": "task_progress",
"task_id": "abc123",
"progress_type": "step",
"message": "Browsing competitor websites..."
}
task_stopped - Fires when a task finishes or pauses:
{
"event": "task_stopped",
"task_id": "abc123",
"stop_reason": "finish",
"attachments": [
{ "fileName": "report.pdf", "fileUrl": "https://private-us-east-1.manuscdn.com/..." }
]
}
stop_reason values:
finish - Task completed normallyask - Task paused, Manus is asking a follow-up question (use multi-turn to reply)
Built-in Connectors
Manus 1.6 can connect to external services during task execution. The user must authorize connectors in their Manus dashboard first.
| Connector | What Manus can do |
|---|
| Gmail | Read, search, send emails |
| Notion | Read/write pages and databases |
| Google Calendar | View/create calendar events |
| Slack | Read channels, send messages |
| Similarweb | Pull website traffic and analytics data |
When creating tasks that involve these services, mention the connector in the prompt:
- "Check my Gmail for unread emails from investors and summarize them"
- "Create a Notion page with the research findings"
- "Look up traffic data for competitor.com using Similarweb"
Recommended Workflow
When the user asks you to delegate a task to Manus:
- Understand the request - determine which template fits (research, report, code, scrape)
- Estimate cost - recommend the appropriate agent profile based on complexity
- Create the task - use the matching template with
createShareableLink: true
- Report submission - tell the user the task ID and expected wait time
- Poll for completion - check status every 15-30 seconds
- Retrieve results - extract text content and download output files
- Deliver to user - present findings and attach any files directly
Important guidelines
- Always poll for completion before telling the user the task is done
- Download output files locally instead of giving manus.im links (they can be unreliable)
- Use
agent mode for tasks that create files or documents
- Set expectations - Manus tasks take 2-10+ minutes for complex work
- Include
createShareableLink: true in every task creation request
- Sanitize filenames when downloading (strip special characters)
- Use multi-turn when the user wants to iterate on previous results
- Use projects when the user has consistent style/format preferences across tasks
Error Recovery
API key invalid or missing
HTTP 401 or 403
Tell the user:
- "Your Manus API key appears to be invalid or missing."
- "Set it with:
export MANUS_API_KEY='your-key-here'"
- "Get a key at https://manus.im"
Task creation failed
HTTP 400 or 500
- Check that the prompt is not empty
- Verify the agent profile is valid (
manus-1.6, manus-1.6-lite, manus-1.6-max)
- Verify the task mode is valid (
agent, chat, adaptive)
- Retry once after a 5-second wait
- If it fails again, report the error to the user
Task failed during execution
When status is failed:
- Report the failure to the user
- Check the response for an error message or reason
- Suggest simplifying the prompt or breaking it into smaller tasks
- Offer to retry with a different agent profile
Rate limiting
HTTP 429
- Wait 30 seconds before retrying
- Inform the user: "Manus rate limit reached. Waiting before retry."
- After 3 failed retries, stop and tell the user to try again later
Network or timeout errors
- Retry the request once after 5 seconds
- If polling times out (no completion after 10 minutes), inform the user the task is still running on Manus servers and give them the task ID to check later
Helper Script Reference
The included scripts/manus.sh provides CLI shortcuts:
manus.sh create "prompt" [profile] - Create a new task
manus.sh get <task_id> - Get full task details
manus.sh status <task_id> - Get status (pending/running/completed/failed)
manus.sh wait <task_id> [timeout] - Wait for completion (default: 600s)
manus.sh files <task_id> - List output files
manus.sh download <task_id> [dir] - Download all output files
manus.sh list [status] - List tasks (optionally filter by status)
manus.sh update <task_id> "new title" - Update task title
manus.sh delete <task_id> - Delete a task
manus.sh upload <filepath> - Upload a file, returns file_id
manus.sh list-files - List recent uploaded files
manus.sh delete-file <file_id> - Delete an uploaded file
manus.sh create-project "name" "instructions" - Create a project
manus.sh list-projects - List projects
manus.sh webhook-create <url> [events] - Create a webhook
manus.sh webhook-delete <webhook_id> - Delete a webhook
Profiles: manus-1.6 (default), manus-1.6-lite, manus-1.6-max
Cross-Skill Integration
- Need real-time web search? Use
/parallel for fast multi-engine web searches that return immediately - good for gathering context before creating a Manus task.
- Need social media / trend research? Use
/last30days for Twitter/X, Reddit, and news monitoring with sentiment analysis.
- Need to read a specific webpage? Use your built-in WebFetch tool rather than sending a full Manus task for a single page.
Manus is best for tasks that require autonomous multi-step work - browsing multiple sites, compiling findings, generating formatted deliverables. For quick lookups, other tools are faster and cheaper.
API Reference
