# 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
- [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
- [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, use [task.confir…
- [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. Action confirmations without confirm_input_schema still use this endpoint. For messageAskUser / cascadeAskUser questions, use [task.sendMessage](https://open.man…
- [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).
- [skill.list](https://open.manus.ai/docs/v2/skill.list.md): 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).
- [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. Then use the `file.id` as `file_id` in [task.create](https://open.manus.ai/docs/v2/task.create) or [task.sendMessage](https://open.manus.ai/docs/v2/task.sendMessa…
- [file.detail](https://open.manus.ai/docs/v2/file.detail.md): Retrieves a file's details including upload status, size, and expiration time. Check that `status` is `uploaded` before using the file in [task.create](https://open.manus.ai/docs/v2/task.create). Files expire 48 hours after upload.
- [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.
- [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 apps cannot access this endpoint; trusted OAuth apps can…
- [usage.teamStatistic](https://open.manus.ai/docs/v2/usage.teamStatistic.md): Returns daily credit consumption totals for the team over a date range.
- [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.
- [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 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](https://open.manus.…
- [website.listCheckpoints](https://open.manus.ai/docs/v2/website.listCheckpoints.md): Lists all checkpoints of a website, 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.manus.ai/docs/v2/website) guide.
- [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 a website's metadata (`title`, `visibility`). Unlike [website.publish](https://open.manus.ai/docs/v2/website.publish), this does not redeploy — only the metadata and CDN are refreshed.
- [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)