Get Tasks

Retrieves a list of tasks with optional filtering and pagination.

GET /v1/tasks

GetTasks

cURL

curl --request GET \
  --url https://api.manus.ai/v1/tasks \
  --header 'API_KEY: <api-key>'

200

{
  "object": "<string>",
  "data": [
    {
      "id": "<string>",
      "object": "<string>",
      "created_at": 123,
      "updated_at": 123,
      "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>",
          "type": "<string>",
          "content": [
            {
              "text": "<string>",
              "fileUrl": "<string>",
              "fileName": "<string>",
              "mimeType": "<string>"
            }
          ]
        }
      ],
      "locale": "<string>",
      "credit_usage": 123
    }
  ],
  "first_id": "<string>",
  "last_id": "<string>",
  "has_more": true
}

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[]

Hide child attributes

data. id · string

Unique identifier for the task

data. object · string

Always "task"

data. created_at · integer<int64>

Unix timestamp (seconds) when the task was created

data. updated_at · integer<int64>

Unix timestamp (seconds) when the task was last updated

data. status · enum<string>

Current status of the task

Available options: pending, running, completed, failed

data. error · string

Error message if the task failed (optional)

data. incomplete_details · string

Details about why the task is incomplete (optional)

data. instructions · string

The original prompt/instructions for the task (optional)

data. max_output_tokens · integer<int32>

Maximum output tokens limit (optional)

data. model · string

Model used for the task

data. metadata · object

Metadata containing task information and optional custom key-value pairs

Hide child attributes

data.metadata. task_title · string

Title of the task

data.metadata. task_url · string

URL to view the task in Manus app (e.g., https://manus.im/app/cvL57MT3sh2McZRjTog8MZ)

data.metadata. {key} · string

data. output · object[]

Array of task messages (conversation history)

Hide child attributes

data.output. id · string

Unique identifier for the message

data.output. status · string

Status of the message

data.output. role · enum<string>

Role of the message sender - "assistant" or "user"

Available options: user, assistant

data.output. type · string

Type here is "message"

data.output. content · object[]

Array of message content items (text or files)

Hide child attributes

data.output.content. type · enum<string>

Content type - "output_text" or "output_file"

Available options: output_text, output_file

data.output.content. text · string

Text content (for output_text type)

data.output.content. fileUrl · string

File URL (for output_file type)

data.output.content. fileName · string

File name (for output_file type)

data.output.content. mimeType · string

MIME type of the file (for output_file type)

data. locale · string

User's preferred locale (optional)

data. credit_usage · integer<int32>

Credits consumed by this task (optional)

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