manus-api
Manage tasks, projects, and other data through the Manus API; build OAuth2 Open Apps and third-party integrations; create Manus tasks programmatically; or install and use the official Manus API skill for services and workflows that need agentic capabilities.
How do I install this agent skill?
npx skills add https://open.manus.ai --skill manus-apiIs this agent skill safe to install?
No partner audit is available yet. Read the source before installing.
What does this agent skill do?
Manus API Integration Guide
Use this skill when building or troubleshooting integrations that call the Manus API, automate Manus agents, retrieve generated results, manage projects/files/webhooks/connectors/skills/agents/usage, request structured JSON outputs, publish or edit websites created by Manus tasks, or implement OAuth2 authorization for third-party apps.
This file is the routing and decision guide. Keep implementation details in the live official documentation under https://open.manus.ai/docs/. When a user asks for exact request bodies, response schemas, validation rules, rate limits, or endpoint-specific edge cases, open the relevant API v2 page instead of relying on this overview.
Version policy. Use API v2 for all new work. Use the API v1 documentation only when the user is maintaining an existing v1 integration, because v1 is deprecated.
Base URL and authentication. Send requests to https://api.manus.ai. Use x-manus-api-key: <key> for your own integrations and scripts, or Authorization: Bearer <access_token> for an Open App acting on behalf of a user. Successful responses use an ok: true envelope; failures use ok: false with error.code, error.message, and request_id. Standard OAuth tokens are scoped and cannot access full-access-only endpoints. Tokens issued to a Trusted team client or Trusted public client bypass scope restrictions. Open the endpoint page to confirm its supported authentication methods.
1. Documentation Routing
Prefer reading the smallest relevant document before answering detailed implementation questions. For endpoint-specific parameters, open https://open.manus.ai/docs/v2/<endpoint>; for the full schema, inspect the API v2 OpenAPI specification. For task skill selection, read the Message.enable_skills and Message.force_skills field descriptions in that schema.
| User intent | Read first |
|---|---|
| Create, continue, stop, delete, or inspect tasks | Task lifecycle, then the relevant task.* endpoint page |
| Answer action confirmations or render a custom confirmation UI | Task lifecycle, then Confirmation Events and task.confirmAction |
| Render Addon interaction cards, such as the Webdev project blueprint | Addon interaction cards, then task.confirmAction |
| Look up one Webdev card: when it appears, its fields, and its answers | Webdev Cards |
| Let the agent read earlier tasks from a new message | Task references |
| Require JSON output that an application can parse | Structured output |
| Publish, manage, or edit a website built by an agent | Website guide, then the relevant website.* endpoint page |
| Upload, download, or reference user files | file.upload, file.detail, file.delete |
| List generated task artifacts | Artifacts guide, then artifact.list |
| Configure real-time callbacks | Webhooks overview, Webhook security |
| Add durable instructions/persona, or change a project's default connectors and skills | project.create, project.list, project.detail, project.update |
| Use connectors, skills, agents, or browser clients | Connectors, connector.list, skill.list, skill.detail, Agents overview, browser.onlineList |
| Upload a personal, team, or project skill package | skill.upload, file.upload |
| Inspect usage, quotas, or logs | usage.list, usage.teamStatistic, usage.teamLog, Rate limits |
| Build an Open App or authorize on behalf of users | Open App, Authentication |
| Send or read hidden application context | Hidden application context |
| Resolve file or website references in task messages | Attachments |
| Identify the user behind an API key or OAuth token | user.me |
| Install the website-hosted Manus API skill | Manus API skill |
2. Endpoint Map
Use this map for orientation only. Open the endpoint page for concrete request and response details.
| Group | Purpose | Representative endpoints |
|---|---|---|
| User | Identify the user associated with the current credential. | user.me |
| Tasks | Agent task lifecycle and multi-turn conversation. | task.create, task.sendMessage, task.listMessages, task.confirmAction, task.stop |
| Projects | Durable shared instructions, default connectors and skills, and organization. | project.create, project.list, project.detail, project.update |
| Files | Upload, inspect, download, and delete files used by tasks. | file.upload, file.detail, file.delete |
| Artifacts | List generated task outputs across the user's Library. | artifact.list |
| Webhooks | Production-grade task lifecycle notifications. | webhook.create, webhook.list, webhook.delete, webhook.publicKey |
| Connectors and Skills | Control third-party app access, skill availability, and personal, team, or project skill uploads. | connector.list, skill.list, skill.detail, skill.upload |
| Agents | List, inspect, and update custom IM agents. | agent.list, agent.detail, agent.update |
| Usage | Retrieve usage records and team statistics. | usage.list, usage.teamStatistic, usage.teamLog |
| Website | Inspect, publish, version, and update websites built by Manus tasks. | website.status, website.listCheckpoints, website.publish, website.update |
3. Core Integration Decisions
Choose the right authentication method. Use an API key for first-party integrations and scripts. Use OAuth2 when building an Open App that acts on behalf of users. Standard team clients are restricted by configured scopes: create_task, manage_all_tasks, create_project, use_connectors, and use_my_browsers. The create_task scope only exposes tasks created by the same client. project.detail and project.update require manage_all_tasks; create_project covers only project.create and project.list. Standard OAuth tokens can call skill.list and skill.detail with create_task or manage_all_tasks. They cannot access agent.*, skill.upload, webhook.create, webhook.list, webhook.delete, or usage.*, but can access user.me, webhook.publicKey, and website.* without an endpoint-specific scope. A Trusted team client or Trusted public client bypasses standard endpoint scope restrictions like an API key. Hidden text content is an additional Trusted public client capability. Open App creation and standard authorization require a Team account. Trusted public client access is partner-only. Read the Open App guide before implementing OAuth2.
Limit skill discovery by caller. skill.list returns only skills owned by the current Open App for standard OAuth clients. API Keys receive the user's available skills; trusted OAuth clients also receive their App skills. Only API Keys and trusted OAuth clients can pass project_id or scope=team; scope=team returns the team skill library to any team member instead of the user's available skills. Listing a skill does not enable it. Read the skill.list guide for the exact response scope. skill.detail returns one skill's metadata and a 24-hour download link for its current archive. Standard OAuth clients can read only their App's skills, as with skill.list; API Keys and trusted clients can read any skill the user can download. Read the skill.detail guide for the response fields.
Upload skills through files. To create or update a personal, team, or project skill, upload the zip package with file.upload, then pass its file_id to skill.upload; set scope to team for a team skill, or pass project_id for a project skill. The package must not exceed 8 MiB and must contain SKILL.md with a name in its front matter. Only API Keys and trusted OAuth clients can upload, and team uploads require a Team Owner, Admin, or Super Admin. A same-name skill is updated only with overwrite: true. Read the skill.upload guide for package rules and errors.
Resolve the authenticated user through the API. Call user.me after OAuth token exchange when the integration needs the stable Manus user ID. API Key and Trusted client callers also receive the user's display name, email, and avatar; Standard OAuth clients receive only user_id. Do not parse undocumented claims from the access token. The endpoint accepts API keys and OAuth tokens without an additional OAuth scope, and it does not modify user data.
Choose the right task flow. For a new independent job, call task.create. For an ongoing thread or conversation, store the task_id and call task.sendMessage on later turns. For direct messaging to the default IM agent, task.sendMessage supports the shortcut task_id: "agent-default-main_task".
Use projects for durable behavior. If the integration needs a persistent persona, formatting rule, or reusable instruction, create or reuse a Project and pass project_id when creating tasks. Do not duplicate large system-style instructions into every user message if a project is the cleaner abstraction. To change an existing project, read it with project.detail and send only the changed fields to project.update; connector_ids and skill_ids replace the entire list.
Use webhooks for production result delivery. Polling task.listMessages is acceptable for scripts and prototypes, but production systems should prefer webhooks and verify signatures with the webhook public key. Still implement idempotency and retries because webhook delivery can be repeated by clients or infrastructure. Route by event_type and ignore unknown types. task_deleted reports deletions of API-created tasks; to reconcile missed events, call task.list with include_deleted=true, which returns deleted tasks as status: "deleted" with deleted_at and no title.
Read results on stopped, and keep polling while task.detail.has_running_background_jobs is true. It means a background process may wake the task again later, add messages, and change the results. Read the Task lifecycle guide for details.
Handle waiting states correctly. If the agent asks the user a normal question, answer with task.sendMessage. For action confirmation, read waiting_for_event_id and confirm_input_schema. Fetch a missing tool target with task.listMessages using verbose=true and start_event_id=waiting_for_event_id, then review its tool_used.params and optional tool_used.result. Build the confirmation input according to the schema and submit it through task.confirmAction. Browser selection, video approval, configuration and OAuth confirmations have no target event; do not use the start-event lookup for them because it returns Event not found. Confirmation Events lists each type's context source, example input, and target event; read it before building a confirmation UI. confirmed: false means the input was not consumed and the task remains waiting. Fallback when status_detail or waiting_for_event_id is missing, the event type is not one you handle, or the target gives you nothing to act on: call task.sendMessage with message.content set to Continue and use your best judgment. (for most action confirmations this skips the pending action; the agent decides how to proceed), or direct a person to open the task in Manus. Do not invent confirmation input. When waiting_for_event_type is addonInteraction, render the addon_interaction card from task.listMessages as described in Addon interaction cards and submit an MCP ElicitResult (action, plus content for accept) through task.confirmAction; never call task.confirmAction for info cards or for a card kind or mode that you do not handle. Read Task lifecycle and task.confirmAction before automating confirmations.
Pick agent profile intentionally. task.create and task.sendMessage accept the stable agent_profile values standard, lite, and max, plus max-medium, max-high, max-extra, and max-ultra to choose a Max thinking level; deeper levels use more credits. Omitting the field on task.create defaults to standard; omitting it on task.sendMessage keeps the task's current profile and thinking level, while passing a value overrides the current and subsequent turns. Versioned profile names are compatibility aliases, not independent model selections. Use the endpoint docs for their accepted format.
Attach tools through message fields. Use message.connectors for connector IDs, message.enable_skills to control available skills, and message.force_skills when a skill must be invoked. Use connector.list and skill.list to discover IDs.
Download uploaded attachments through file.detail. After uploading bytes, use this endpoint to obtain a temporary GET link for content validation before creating a task. Download fields are optional. Links expire; read file.detail for availability and refresh rules.
Follow artifact pagination until has_more is false. Keep the user, credential scope, filters, and page size unchanged. Short or empty pages can still have a next cursor; retry transient failures with the same cursor. The server deduplicates IDs and Addon resources across one traversal. Apply a cursor replay as a replacement for that page. Cursors expire after 5 minutes idle or 15 minutes total; restart on an expired cursor. Deduplicate by resource_uri when present, otherwise by id, when merging separate traversals. Use the returned type for classification; do not infer it from the filename or platform. Read Artifacts guide for categories and live-list semantics.
Respect artifact source visibility. Sources identify the creation task rather than the latest editor. A missing source does not imply UI creation. Credential-filtered lists may omit older artifacts without indexed source metadata. Restricted create_task OAuth clients always have an implicit filter for their own app; omitting source filters cannot recover those historical artifacts. Historical source metadata is not backfilled as part of this release.
Resolve output attachments from message context. task.listMessages returns original message content without rewriting file paths or Manus protocols. Render HTTP/HTTPS normally. Match file destinations to attachments[].path, and resolve manus-webdev://<version_id> through website.listCheckpoints for the same task. If the required context is absent or another non-HTTP protocol is unsupported, remove that link or image node in the client while preserving surrounding text. See Attachments. Request attachment thumbnails with include_cover=true only when rendering covers; cover_image_status is ready, pending, or unsupported.
Reference existing tasks to reuse prior work. Pass message.task_references (task IDs) on task.create or task.sendMessage so the agent can browse those tasks' conversation and files on demand instead of you re-sending their content. References accumulate across turns and cannot be cleared. Access is checked when the agent reads, except that a create_task-scope OAuth client may reference only its own tasks. Read Task references for validation rules and limits.
Edit an existing website in a new task. Set the top-level website field ({"id": "<website_id>"}) on task.create and put a non-empty text instruction in message.content; the new task edits that website. Only task.create has this field, website is not a content part, and only web websites owned by the authorized user are accepted (not mobile apps or games). Read the Website guide for the rules and errors.
Open a sandbox preview only while it is running. website.status with task_id returns preview_url and sandbox_status. preview_url responds only while sandbox_status is running; it is temporary, so do not store or share it. To bring back a paused preview, send a message with task.sendMessage (requires permission to send messages to the task; runs the agent and consumes credits), then poll website.status with an upper bound. Read the Website guide.
Hidden context requires a Trusted public client. Only text parts may use visibility: "hidden", and every create/send message must retain a valid visible part. User-facing history omits hidden text; a Trusted public client with task access can read it through task.listMessages?verbose=true. See Hidden application context for the contract.
4. Structured Output Guidance
Use Structured Output when the integration needs machine-parseable JSON rather than human-facing prose. Before writing schemas or code, read the Structured output guide.
Remember only the routing-level behavior here: pass structured_output_schema to task.create or task.sendMessage; extraction runs after the agent finishes; schemas are arm once, fire once and can be re-armed on later turns; results appear in task.listMessages as structured_output_result or in webhooks as task_stopped.task_detail.structured_output. Always check success before trusting value.
5. Operational Limits
Confirm limits in the relevant endpoint page before relying on them because they may change.
- User text is limited to approximately 5,000 estimated tokens per request. This applies to v1 task prompts, OpenAI-compatible Responses input, and v2
task.create/task.sendMessage; multipart input is estimated across all text parts combined, while file parts do not count. file.uploadaccepts files up to 512 MB and enforces 10 GB total storage per account. Exceeding either limit returnsQuotaExceededError. Its upload URL expires after 3 minutes, uploaded files are deleted after 48 hours, and executable or script file types are prohibited.- A task attachment using
file_idinherits thefile.uploadlimit. Directfile_urland decodedfile_dataattachments are limited to 20 MB; 20 MB of decoded data is approximately 26.7 MB of base64 text. There is no hard limit on the number of attachments per message. message.task_referencesaccepts up to 20 task IDs per request ontask.createandtask.sendMessage; entries must be bare 22-character task IDs (a full task URL or theagent-default-main_taskshortcut is rejected withInvalidArgument), and the cap is checked before duplicates are removed. References accumulate across turns; a task that accumulates more than 20 keeps the 20 most recently referenced.
6. Minimal Implementation Pattern
A typical closed-loop integration follows this sequence: upload files if needed with file.upload; create or reuse a project for durable instructions; call task.create; deliver results through webhooks or poll task.listMessages; continue with task.sendMessage if the conversation needs another turn; and use task.confirmAction only for explicit action confirmations.
For structured-output tasks, add a post-task step that reads either the structured_output_result event or the webhook structured_output field.
References
Open these live pages for authoritative details:
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/open.manus.ai/manus-api">View manus-api on skillZs</a>