Skip to main content
GET
/
v1
/
tasks
/
{task_id}
GetTask
curl --request GET \
  --url https://api.manus.ai/v1/tasks/{task_id} \
  --header 'API_KEY: <api-key>'
{
  "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
}
Retrieve detailed information about a specific task by its ID. This includes the task’s status, output messages, credit usage, and metadata. Use the convert query parameter to convert pptx files in the task output.

Authorizations

API_KEY
string
header
required

Path Parameters

task_id
string
required

The ID of the task to retrieve

Query Parameters

convert
boolean
default:false

Whether to convert the task output. Currently only applies for pptx files.

Response

200 - application/json

Task retrieved successfully.

id
string

Unique identifier for the task

object
string

Always "task"

created_at
integer<int64>

Unix timestamp (seconds) when the task was created

updated_at
integer<int64>

Unix timestamp (seconds) when the task was last updated

status
enum<string>

Current status of the task

Available options:
pending,
running,
completed,
failed
error
string

Error message if the task failed (optional)

incomplete_details
string

Details about why the task is incomplete (optional)

instructions
string

The original prompt/instructions for the task (optional)

max_output_tokens
integer<int32>

Maximum output tokens limit (optional)

model
string

Model used for the task

metadata
object

Metadata containing task information and optional custom key-value pairs

output
object[]

Array of task messages (conversation history)

locale
string

User's preferred locale (optional)

credit_usage
integer<int32>

Credits consumed by this task (optional)