For Agents
Hand off autonomous tasks to the Manus AI agent platform — including file upload, task creation, project grouping, and completion webhooks — through an API-key REST API.
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Manus Integrations API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with Manus Integrations API.
Upload a file to Manus and reference it from a downstream task
Create a Manus task with a prompt, attached files, and target project
List active and completed tasks across the workspace
GET STARTED
Use for: Upload a PDF and create a Manus task to summarise it, Create a new Manus project for the Q3 research workstream, List all completed Manus tasks from the last 24 hours, Cancel the running Manus task with id task_123
Not supported: Does not handle direct LLM completions, embeddings, or fine-tuning — use for delegating long-running autonomous tasks to the Manus agent only.
Jentic publishes the only available OpenAPI specification for Manus Integrations API, keeping it validated and agent-ready. Manus is an AI agent platform that runs autonomous tasks on behalf of a user; the Integrations API is the surface external systems use to feed work into Manus and read results back. The endpoints cover files (upload and reference), tasks (create, list, update, delete), projects (group related tasks), and webhooks (receive completion notifications). Authentication uses an API key sent in the API_KEY header.
Group related tasks under a Manus project for organisation and reporting
Register a webhook to receive notification when a task finishes
Update or cancel a task before it completes
Patterns agents use Manus Integrations API for, with concrete tasks.
★ Hand off a long-running research task
Knowledge workers need an autonomous agent to run a multi-hour research job — gathering sources, comparing options, drafting a memo — without blocking the user. POST /v1/files uploads any seed documents, POST /v1/tasks creates the task with the prompt and file references, and the Manus agent executes asynchronously. A registered webhook delivers the result so the calling system can surface it when ready.
Upload a brief PDF, create a Manus task titled 'Compare top 3 vendors mentioned in the brief', and store the returned task_id.
Project-scoped task tracking
Teams running parallel Manus workstreams need each task associated with the right project for reporting and billing. POST /v1/projects creates a project, then POST /v1/tasks references the project_id when creating tasks. GET /v1/tasks filtered by project returns the per-project task list for status reviews.
Create a project named 'Customer Discovery Q3' and submit five Manus tasks under it, one per discovery interview.
Webhook-driven result handling
Apps that integrate Manus need to be told when tasks finish rather than poll. POST /v1/webhooks registers a callback URL; Manus posts the task id and outcome when the task completes, and the calling system can call GET /v1/tasks/{task_id} to retrieve the full result. This avoids long-poll loops on the client side.
Register the webhook https://app.example.com/manus/done and verify it fires by creating a short test task.
Agent-to-agent delegation through Jentic
An orchestrator agent inside Jentic can offload heavyweight, multi-step subtasks to Manus while focusing on user-facing dialogue. The orchestrator searches Jentic for 'create a manus task', loads the schema, and executes with the Manus API key kept in the vault. The orchestrator returns to the user as soon as Manus accepts the task and finalises when the webhook fires.
Given a user request 'do deep research on lithium battery suppliers', delegate to Manus by uploading a brief and creating a task, then return the task_id.
13 endpoints — jentic publishes the only available openapi specification for manus integrations api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/v1/files
Upload a file
/v1/files/{file_id}
Retrieve file metadata
/v1/tasks
Create a Manus task
/v1/tasks
List Manus tasks
/v1/tasks/{task_id}
Retrieve a task and its result
/v1/tasks/{task_id}
Update an existing task
/v1/projects
Create a project
/v1/webhooks
Register a webhook
/v1/files
Upload a file
/v1/files/{file_id}
Retrieve file metadata
/v1/tasks
Create a Manus task
/v1/tasks
List Manus tasks
/v1/tasks/{task_id}
Retrieve a task and its result
Three things that make agents converge on Jentic-routed access.
Credential isolation
Manus API keys are stored encrypted in the Jentic vault and injected into the API_KEY header at call time. Agents receive a scoped session — the raw key never appears in the prompt or transcript.
Intent-based discovery
Agents search Jentic by intent (e.g. 'create a manus task') and Jentic returns the matching POST /v1/tasks operation with its full input schema, so the agent can hand off without reading the Manus integration docs.
Time to first call
Direct Manus integration: 1 day for auth, file upload flow, and webhook handling. Through Jentic: under an hour — search, load schema, execute.
Alternatives and complements available in the Jentic catalogue.
Specific to using Manus Integrations API through Jentic.
Why is there no official OpenAPI spec for Manus Integrations API?
Manus does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Manus Integrations API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the Manus Integrations API use?
Manus uses an API key sent in the API_KEY header (declared as apiKey in the spec, despite the bearerAuth scheme name). Keys come from the Manus account UI. Through Jentic the API key is stored encrypted in the vault and injected at call time, so the raw key never enters the agent's prompt.
Can I attach files to a Manus task?
Yes. Upload the file with POST /v1/files first, capture the returned file_id, then reference that id in the file array on POST /v1/tasks. The agent can then read the uploaded content as part of executing the task.
What are the rate limits for the Manus Integrations API?
The spec does not publish hard rate limits. Manus is designed for relatively low-frequency, long-running tasks rather than high-QPS workloads, so rate limits are applied at the workspace level for task creation. Honour 429 responses with the Retry-After header rather than retrying immediately.
How do I create a Manus task through Jentic?
Run pip install jentic, then search Jentic for 'create a manus task'. Jentic returns the POST /v1/tasks operation with its input schema, which you execute with the prompt, optional file_ids, and optional project_id to hand the task off to the Manus agent.
How do I find out when a Manus task is done?
Register a webhook with POST /v1/webhooks pointing at your callback URL. Manus posts task lifecycle events to that URL when the task completes; your handler then calls GET /v1/tasks/{task_id} to fetch the full result. Polling is possible but webhooks are the recommended pattern.
/v1/tasks/{task_id}
Update an existing task
/v1/projects
Create a project
/v1/webhooks
Register a webhook