# Manus API

- [Introduction](https://open.manus.ai/docs/v2/introduction.md): Integrate Manus AI agents into your workflows with the Manus API
- [Authentication](https://open.manus.ai/docs/v2/authentication.md): Authenticate with the Manus API using API keys or OAuth2 tokens
- [Task Lifecycle](https://open.manus.ai/docs/v2/task-lifecycle.md): Poll task status, handle confirmations, and process results
- [Task References](https://open.manus.ai/docs/v2/task-references.md): Let the agent read earlier tasks from a new message
- [Connectors](https://open.manus.ai/docs/v2/connectors.md): Connect external apps to Manus and use them in API tasks
- [Overview](https://open.manus.ai/docs/v2/webhooks-overview.md): Real-time notifications for task lifecycle events
- [Webhook Security](https://open.manus.ai/docs/v2/webhooks-security.md): Verify webhook signatures to ensure requests are from Manus
- [Agents](https://open.manus.ai/docs/v2/agents-overview.md): Interact with agents and their tasks via the API
- [Overview](https://open.manus.ai/docs/v2/integrations-overview.md): Use Manus from your favorite apps
- [Slack](https://open.manus.ai/docs/v2/integrations-slack.md)
- [Overview](https://open.manus.ai/docs/v2/data-integrations-overview.md): Access built-in third-party data directly in Manus
- [Similarweb](https://open.manus.ai/docs/v2/data-integrations-similarweb.md): Access website traffic and digital market intelligence data
- [Website](https://open.manus.ai/docs/v2/website.md): Manage websites built by Manus agents — inspect, version, publish, and configure
- [Rate Limits](https://open.manus.ai/docs/v2/rate-limits.md): Per-user request limits for v2 endpoints
- [Structured Output](https://open.manus.ai/docs/v2/structured-output.md): Get agent results in a specific JSON format
- [Open App](https://open.manus.ai/docs/v2/open-app.md): Build an Open App to act on behalf of team users via OAuth2
- [Manus API skill](https://open.manus.ai/docs/v2/manus-api-skill.md): Install the official Manus API skill in Codex and other compatible coding agents
- [Attachments](https://open.manus.ai/docs/v2/attachments.md): Resolve file and website references in task message content.
- [Artifacts](https://open.manus.ai/docs/v2/artifacts.md): List, filter, and page through generated task outputs in the Manus Library
- [Hidden application context](https://open.manus.ai/docs/v2/hidden-application-context.md): Send application context to the agent without rendering it as user-visible message text.
- [user.me](https://open.manus.ai/docs/v2/user.me.md): Returns the Manus user ID associated with the authenticated API key or OAuth2 access token. API Key and Trusted client callers also receive the user's display name, email, and avatar. This endpoint is read-only and does not require an OAuth scope.
- [task.create](https://open.manus.ai/docs/v2/task.create.md): Creates a new task. The task runs asynchronously. Poll for progress with [task.listMessages](https://open.manus.ai/docs/v2/task.listMessages), send follow-ups with [task.sendMessage](https://open.manus.ai/docs/v2/task.sendMessage). See the [Task Lifecycle](https://open.manus.ai/docs/v2/task-lifecycl…
- [task.detail](https://open.manus.ai/docs/v2/task.detail.md): Retrieves a task's status and metadata. Use [task.listMessages](https://open.manus.ai/docs/v2/task.listMessages) for the full event history, or [task.sendMessage](https://open.manus.ai/docs/v2/task.sendMessage) to continue the conversation.
- [task.list](https://open.manus.ai/docs/v2/task.list.md): Lists tasks with optional filtering and cursor-based pagination. Use `scope` to filter by task type, e.g. `agent_subtask` with `agent_id` for agent subtasks. See [task.detail](https://open.manus.ai/docs/v2/task.detail) for full details on a specific task.
- [task.update](https://open.manus.ai/docs/v2/task.update.md): Updates a task's metadata (title, sharing, visibility). Use [task.detail](https://open.manus.ai/docs/v2/task.detail) to see the current values before updating.
- [task.stop](https://open.manus.ai/docs/v2/task.stop.md): Stops a running task. The task status will change to `stopped`. A stopped task can still be resumed with [task.sendMessage](https://open.manus.ai/docs/v2/task.sendMessage).
- [task.delete](https://open.manus.ai/docs/v2/task.delete.md): Deletes a task permanently. If the task is still running, use [task.stop](https://open.manus.ai/docs/v2/task.stop) first.
- [task.sendMessage](https://open.manus.ai/docs/v2/task.sendMessage.md): Sends a follow-up message to a task for multi-turn conversation. Use this after [task.create](https://open.manus.ai/docs/v2/task.create) to continue talking, or to answer `messageAskUser` / `cascadeAskUser` questions with ordinary message.content. For supported action confirmations, review confirm_i…
- [task.listMessages](https://open.manus.ai/docs/v2/task.listMessages.md): Lists event messages for a task with cursor-based pagination. Use this to poll for progress after [task.create](https://open.manus.ai/docs/v2/task.create) or [task.sendMessage](https://open.manus.ai/docs/v2/task.sendMessage). See the [Task Lifecycle](https://open.manus.ai/docs/v2/task-lifecycle) gui…
- [task.confirmAction](https://open.manus.ai/docs/v2/task.confirmAction.md): Confirms a supported pending action when [task.listMessages](https://open.manus.ai/docs/v2/task.listMessages) shows agent_status: waiting. Build input according to confirm_input_schema and review the event identified by waiting_for_event_id for tool params and result. For messageAskUser / cascadeAsk…
- [project.create](https://open.manus.ai/docs/v2/project.create.md): Creates a new project. Projects let you group related tasks and apply shared instructions. Pass the returned ID as `project_id` in [task.create](https://open.manus.ai/docs/v2/task.create) to create tasks within this project.
- [project.list](https://open.manus.ai/docs/v2/project.list.md): Lists all projects. Use the returned IDs as `project_id` in [task.create](https://open.manus.ai/docs/v2/task.create) or [task.list](https://open.manus.ai/docs/v2/task.list).
- [project.detail](https://open.manus.ai/docs/v2/project.detail.md): Retrieves a project's full configuration: name, instruction, default connectors, and default skills. [project.list](https://open.manus.ai/docs/v2/project.list) returns only each project's ID, name, and creation time; call this endpoint before [project.update](https://open.manus.ai/docs/v2/project.up…
- [project.update](https://open.manus.ai/docs/v2/project.update.md): Updates a project's name, instruction, default connectors, or default skills. Omitted fields are unchanged; a request with no updatable field returns `400 invalid_argument`. `connector_ids` and `skill_ids` replace the entire list. Returns the full updated configuration in the same shape as [project.…
- [skill.list](https://open.manus.ai/docs/v2/skill.list.md): Lists installed skills available for task selection.
- [skill.detail](https://open.manus.ai/docs/v2/skill.detail.md): Retrieves one skill's details and a temporary download URL for its current archive.
- [agent.list](https://open.manus.ai/docs/v2/agent.list.md): Lists all custom agents in your account. Use the returned IDs in [task.list](https://open.manus.ai/docs/v2/task.list) with `scope=agent_subtask` to view subtasks, or in [agent.detail](https://open.manus.ai/docs/v2/agent.detail) for full details. See the [Agents](https://open.manus.ai/docs/v2/agents-…
- [agent.detail](https://open.manus.ai/docs/v2/agent.detail.md): Retrieves an agent's details including its nickname, description, and associated task. Use [agent.update](https://open.manus.ai/docs/v2/agent.update) to modify, or [task.list](https://open.manus.ai/docs/v2/task.list) with `scope=agent_subtask` to view this agent's subtasks.
- [agent.update](https://open.manus.ai/docs/v2/agent.update.md): Updates an agent's nickname and description. Use [agent.detail](https://open.manus.ai/docs/v2/agent.detail) to view current values before updating.
- [file.upload](https://open.manus.ai/docs/v2/file.upload.md): Creates a file record and returns a presigned upload URL. Upload the file content to the returned `upload_url` via PUT before it expires. Use [file.detail](https://open.manus.ai/docs/v2/file.detail) to check upload status or download the file. Then use the `file.id` as `file_id` in [task.create](htt…
- [file.detail](https://open.manus.ai/docs/v2/file.detail.md): Retrieves a file's details including upload status, size, and expiration time. For an uploaded, unexpired file, also returns a temporary GET download URL and its expiration time at the top level of the response. Use this to download an uploaded attachment for validation before creating a task. Check…
- [file.delete](https://open.manus.ai/docs/v2/file.delete.md): Deletes a file. Files are automatically deleted 48 hours after upload, so manual deletion is only needed for early cleanup.
- [artifact.list](https://open.manus.ai/docs/v2/artifact.list.md): Lists generated task artifacts from the authenticated user's Manus Library, newest first. Temporary input files from file.upload are not included. See the [Artifacts](https://open.manus.ai/docs/v2/artifacts) guide.
- [webhook.create](https://open.manus.ai/docs/v2/webhook.create.md): Creates a webhook for receiving task event notifications. Use [webhook.publicKey](https://open.manus.ai/docs/v2/webhook.publicKey) to get the key for verifying signatures. See the [Webhooks](https://open.manus.ai/docs/v2/webhooks-overview) guide for event types.
- [webhook.list](https://open.manus.ai/docs/v2/webhook.list.md): Lists all webhooks in your account. Use the returned IDs with [webhook.delete](https://open.manus.ai/docs/v2/webhook.delete) to remove a webhook.
- [webhook.delete](https://open.manus.ai/docs/v2/webhook.delete.md): Deletes a webhook. The endpoint will stop receiving notifications immediately. Use [webhook.list](https://open.manus.ai/docs/v2/webhook.list) to find the webhook ID.
- [webhook.publicKey](https://open.manus.ai/docs/v2/webhook.publicKey.md): Gets the public key for verifying webhook signatures. See the [Webhook Security](https://open.manus.ai/docs/v2/webhooks-security) guide for verification examples.
- [usage.list](https://open.manus.ai/docs/v2/usage.list.md): Lists the current user's credit change history at session granularity, sorted by change time (newest first).
- [usage.availableCredits](https://open.manus.ai/docs/v2/usage.availableCredits.md): Returns the credit balance, subscription period, and refresh information for the authenticated caller. For a team sub-account, the team's shared pool balance is returned; for a personal account, the personal balance is returned. Standard OAuth clients cannot access this endpoint; trusted clients can…
- [usage.teamStatistic](https://open.manus.ai/docs/v2/usage.teamStatistic.md): Returns daily credit consumption totals for the team over a date range. Owners and admins see the whole team; members see only their own consumption.
- [usage.teamLog](https://open.manus.ai/docs/v2/usage.teamLog.md): Lists team members' task counts and total credit consumption over the requested range, one row per user. Owners and admins see every member; members see only their own row. Enterprise teams have T+1 latency: today's data is visible the next day. Other teams aggregate in real time.
- [connector.list](https://open.manus.ai/docs/v2/connector.list.md): Lists connectors installed in the current user's account. Use the returned IDs in the `connectors` array of [task.create](https://open.manus.ai/docs/v2/task.create) or [task.sendMessage](https://open.manus.ai/docs/v2/task.sendMessage). See the [Connectors](https://open.manus.ai/docs/v2/connectors) g…
- [browser.onlineList](https://open.manus.ai/docs/v2/browser.onlineList.md): Lists the user's online browser clients. Use the returned `client_id` with [task.confirmAction](https://open.manus.ai/docs/v2/task.confirmAction) when the agent triggers a `needConnectMyBrowser` waiting event. See the [Task Lifecycle](https://open.manus.ai/docs/v2/task-lifecycle#using-my-browser) gu…
- [website.status](https://open.manus.ai/docs/v2/website.status.md): Retrieves a website's current title, publish status, live URL, and visibility. Use [website.listCheckpoints](https://open.manus.ai/docs/v2/website.listCheckpoints) to browse version history, or [website.publish](https://open.manus.ai/docs/v2/website.publish) to deploy changes. See the [Website](http…
- [website.listCheckpoints](https://open.manus.ai/docs/v2/website.listCheckpoints.md): Returns the website's current title and lists all of its checkpoints, newest first. Match `published_version_id` against `data[].version_id` to identify the live checkpoint, or call [website.publish](https://open.manus.ai/docs/v2/website.publish) to deploy the latest. See the [Website](https://open.…
- [website.publish](https://open.manus.ai/docs/v2/website.publish.md): Deploys the latest checkpoint of a website and sets its visibility. Deployment is asynchronous — poll [website.status](https://open.manus.ai/docs/v2/website.status) until `publish_status` becomes `published` or `failed`. To change metadata (title, visibility) without redeploying, use [website.update…
- [website.update](https://open.manus.ai/docs/v2/website.update.md): Updates website configuration without deploying. Omitted fields are unchanged; a request with no updatable field returns `400 invalid_argument`. Use [website.publish](https://open.manus.ai/docs/v2/website.publish) to deploy a new version. See the [Website](https://open.manus.ai/docs/v2/website) guid…
- [Overview](https://open.manus.ai/docs/v1/overview.md): Complete guide to Manus API - integrate AI agents into your workflows
- [Quickstart](https://open.manus.ai/docs/v1/quickstart.md): Generate an API key and make your first call.
- [Overview](https://open.manus.ai/docs/v1/api-overview.md)
- [Create Project](https://open.manus.ai/docs/v1/create-project.md): Creates a new project to organize tasks and apply consistent instructions.
- [List Projects](https://open.manus.ai/docs/v1/list-projects.md): Retrieves a list of all projects in your account.
- [Create Task](https://open.manus.ai/docs/v1/create-task.md): Creates a new task.
- [Get Tasks](https://open.manus.ai/docs/v1/get-tasks.md): Retrieves a list of tasks with optional filtering and pagination.
- [Get Task](https://open.manus.ai/docs/v1/get-task.md): Retrieves details of a specific task by ID.
- [Update Task](https://open.manus.ai/docs/v1/update-task.md): Updates a task's metadata.
- [Delete Task](https://open.manus.ai/docs/v1/delete-task.md): Deletes a task by ID.
- [Create File](https://open.manus.ai/docs/v1/create-file.md): Creates a file record and returns a presigned URL for uploading the file content to S3.
- [List Files](https://open.manus.ai/docs/v1/list-files.md): Retrieves a list of the 10 most recently uploaded files.
- [Get File](https://open.manus.ai/docs/v1/get-file.md): Retrieves details of a specific file by ID.
- [Delete File](https://open.manus.ai/docs/v1/delete-file.md): Deletes a file by ID. This removes both the file record and the file from S3 storage.
- [Create Webhook](https://open.manus.ai/docs/v1/create-webhook.md): Creates a new webhook.
- [Delete Webhook](https://open.manus.ai/docs/v1/delete-webhook.md): Deletes a webhook.
- [Overview](https://open.manus.ai/docs/v1/webhooks/overview.md): Real-time notifications for task lifecycle events
- [Security](https://open.manus.ai/docs/v1/webhooks/security.md): Best practices for securing your webhook endpoints
- [OpenAI SDK Compatibility](https://open.manus.ai/docs/v1/openai-compatibility/overview.md): Use the OpenAI Python SDK with Manus
- [Overview](https://open.manus.ai/docs/v1/connectors/overview.md): Connect your apps to Manus for AI-powered automation
- [Gmail](https://open.manus.ai/docs/v1/connectors/gmail.md): Connect Manus to your Gmail account to manage emails with AI
- [Notion](https://open.manus.ai/docs/v1/connectors/notion.md): Connect Manus to your Notion workspace for AI-powered knowledge management
- [Google Calendar](https://open.manus.ai/docs/v1/connectors/google-calendar.md): Connect Manus to your Google Calendar for AI-powered scheduling and calendar management
- [Overview](https://open.manus.ai/docs/v1/integrations/overview.md): Use Manus from your favorite apps
- [Slack](https://open.manus.ai/docs/v1/integrations/slack.md)
- [Overview](https://open.manus.ai/docs/v1/data-integrations/overview.md): Access built-in third-party data directly in Manus
- [Similarweb](https://open.manus.ai/docs/v1/data-integrations/similarweb.md): Access website traffic and digital market intelligence data

## OpenAPI Specs

- [openapi](/docs/v1/openapi.json)
- [openapi_v2](/docs/v2/openapi_v2.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.