Skip to main content
GET
/
v1
/
tasks
GetTasks
curl --request GET \
  --url https://api.manus.ai/v1/tasks \
  --header 'API_KEY: <api-key>'
{
  "object": "<string>",
  "data": [
    {
      "id": "<string>",
      "object": "<string>",
      "created_at": 123,
      "updated_at": 123,
      "status": "pending",
      "error": "<string>",
      "incomplete_details": "<string>",
      "instructions": "<string>",
      "max_output_tokens": 123,
      "model": "<string>",
      "metadata": {
        "task_title": "<string>",
        "task_url": "<string>"
      },
      "output": [
        {
          "id": "<string>",
          "status": "<string>",
          "role": "user",
          "type": "<string>",
          "content": [
            {
              "type": "output_text",
              "text": "<string>",
              "fileUrl": "<string>",
              "fileName": "<string>",
              "mimeType": "<string>"
            }
          ]
        }
      ],
      "locale": "<string>",
      "credit_usage": 123
    }
  ],
  "first_id": "<string>",
  "last_id": "<string>",
  "has_more": true
}

Documentation Index

Fetch the complete documentation index at: https://open.manus.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

API v1 is deprecated and will be removed in the future. Please migrate to API v2 for new features and long-term support.
Retrieve a list of tasks with optional filtering and pagination. This endpoint allows you to search, filter, and paginate through your tasks.

​
Query Parameters

Use these parameters to filter and paginate through tasks:
  • after: Cursor for pagination (ID of the last task from previous page)
  • limit: Maximum number of tasks to return (default: 100, range: 1-1000)
  • order: Sort direction - “asc” or “desc” (default: “desc”)
  • orderBy: Sort field - “created_at” or “updated_at” (default: “created_at”)
  • query: Search term to filter by title and body content
  • status: Array of status values to filter by - “pending”, “running”, “completed”, “failed”
  • createdAfter: Unix timestamp to filter tasks created after this time
  • createdBefore: Unix timestamp to filter tasks created before this time
  • project_id: Filter tasks by project ID - returns only tasks belonging to the specified project

Authorizations

​
API_KEY
string
header
required

Query Parameters

​
after
string

Cursor for pagination. ID of the last task from the previous page.

​
limit
integer<int32>

Maximum number of tasks to return. Default: 100, Range: 1-1000.

​
order
string

Sort direction: "asc" or "desc". Default: "desc".

​
orderBy
string

Sort field: "created_at" or "updated_at". Default: "created_at".

​
query
string

Search term to filter by title and body content.

​
status
string[]

Filter by task status: "pending", "running", "completed", "failed".

​
createdAfter
integer<int64>

Filter tasks created after this Unix timestamp (seconds).

​
createdBefore
integer<int64>

Filter tasks created before this Unix timestamp (seconds).

​
project_id
string

Filter tasks by project ID. Returns only tasks belonging to the specified project.

Response

200 - application/json

Tasks retrieved successfully.

​
object
string

Always "list"

​
data
object[]
​
first_id
string

ID of the first task in the list

​
last_id
string

ID of the last task in the list (use as 'after' for next page)

​
has_more
boolean

Whether there are more tasks available