Introduction

You are viewing API v2 — the latest version of the Manus API. API v1 has been deprecated and will be removed in the future. If you still need the v1 docs, see API v1 documentation.

Manus API

The Manus API allows you to programmatically create and manage AI agent tasks. Build automations, orchestrate multi-step workflows, and integrate Manus into your applications through a simple REST API.

Get your API key

Before making API calls, you’ll need to create an API key. Head over to Authentication to get started.

Install the API skill

Give Codex and other compatible coding agents current Manus API integration guidance.

What you can do

Tasks

Create tasks, send follow-up messages, and retrieve results — full multi-turn conversation support

Projects

Organize tasks with shared instructions that apply automatically

Files

Upload files as task attachments — PDFs, images, CSVs, and more

Webhooks

Get real-time notifications when tasks complete or need input

Skills

Extend agent capabilities with built-in and custom skills

Agents

Manage and configure your custom agents

Response format

All responses use a consistent wrapper:

Success:

{
  "ok": true,
  "request_id": "req_abc123",
  ...
}

Error:

{
  "ok": false,
  "request_id": "req_abc123",
  "error": {
    "code": "invalid_argument",
    "message": "task_id is required"
  }
}

Error code	Description
`unauthenticated`	Missing or invalid API key or OAuth token
`invalid_argument`	Missing or invalid request parameters
`not_found`	The requested resource does not exist
`permission_denied`	The authenticated caller lacks permission or a required OAuth scope
`rate_limited`	Too many requests — see Rate Limits for per-endpoint limits and backoff guidance
`internal`	Internal server error (HTTP 500)

Getting Started

API Reference

Manus API

Get your API key

Install the API skill

What you can do

Tasks

Projects

Files

Webhooks

Skills

Agents

Base URL

Response format

​Manus API

Get your API key

Install the API skill

​What you can do

Tasks

Projects

Files

Webhooks

Skills

Agents

​Base URL

​Response format

Manus API

What you can do

Base URL

Response format