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": {},
  "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.

Authorizations

API_KEY
string
header
required

Path Parameters

task_id
string
required

The ID of the task to retrieve

Response

200 - application/json

Task retrieved successfully.

id
string

Unique identifier for the task

object
string

Always "task"

created_at
integer

Unix timestamp (seconds) when the task was created

updated_at
integer

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

Maximum output tokens limit (optional)

model
string

Model used for the task

metadata
object

Custom metadata key-value pairs

output
object[]

Array of task messages (conversation history)

locale
string

User's preferred locale (optional)

credit_usage
integer

Credits consumed by this task (optional)

I