artifact.list

GET

artifact.list

ListArtifacts

curl --request GET \
  --url https://api.manus.ai/v2/artifact.list

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.manus.ai/v2/artifact.list",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.manus.ai/v2/artifact.list"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.manus.ai/v2/artifact.list")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "ok": true,
  "request_id": "<string>",
  "data": [
    {
      "id": "<string>",
      "task_id": "<string>",
      "task_title": "<string>",
      "filename": "<string>",
      "display_name": "<string>",
      "type": "spreadsheets",
      "file_type": "file",
      "content_type": "<string>",
      "url": "<string>",
      "cover_image": "<string>",
      "favorite": true,
      "updated_at": 123,
      "platform_type": 123,
      "logo": "<string>",
      "resource_uri": "<string>",
      "source": {
        "kind": "oauth_client",
        "oauth_client_id": "<string>",
        "api_key_id": "<string>",
        "name": "<string>"
      }
    }
  ],
  "has_more": true,
  "next_cursor": "<string>"
}

{
  "ok": false,
  "request_id": "<string>",
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

{
  "ok": false,
  "request_id": "<string>",
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

{
  "ok": false,
  "request_id": "<string>",
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

^{Questions or issues? Contact us at api-support@manus.ai.} Lists the generated artifacts in the authenticated user’s Manus Library. This endpoint returns task outputs. It does not return temporary files uploaded through file.upload.

Auth: API Key or OAuth token. An OAuth client requires the create_task or manage_all_tasks scope unless it is a Trusted team client or Trusted public client. With create_task scope, this endpoint only returns artifacts from tasks created by the same OAuth client. manage_all_tasks returns all of the user’s artifacts.

Filters

All filters are combined with AND semantics.

Parameter	Description
`name`	Searches the artifact display name. Results remain ordered by creation time, including name searches.
`type`	Filters by Library category. Defaults to `all`.
`favorite`	When `true`, returns only favorited artifacts. Omit it or pass `false` to include both favorited and non-favorited artifacts.
`oauth_client_id`	Returns artifacts from tasks created by the specified Open App.
`api_key_id`	Returns artifacts from tasks created by the specified API key.
`cursor`	Opaque cursor from the previous response’s `next_cursor`. Omit it for the first page.
`limit`	Results per page. Defaults to `20`; maximum `100`.

oauth_client_id and api_key_id are mutually exclusive. Passing both returns 400 invalid_argument. OAuth apps with only create_task are already limited to their own app’s tasks: filtering by api_key_id or by another app’s oauth_client_id returns 403 permission_denied. When neither credential filter is present, API keys, OAuth apps with manage_all_tasks, and trusted OAuth clients can list all artifacts owned by the user, including outputs from Manus UI tasks. Restricted OAuth apps with only create_task always have an implicit source filter for their own app, even when neither parameter is sent. Credential-filtered lists may omit older artifacts that lack indexed source metadata. This also applies to the implicit filter for restricted create_task OAuth apps; omitting the filter parameters does not make those artifacts accessible to that app. An unfiltered request with an API key, manage_all_tasks, or a trusted OAuth client can still return these artifacts. Historical source metadata is not backfilled as part of this release.

Artifact categories

`type`	Included formats
`all`	All generated artifacts
`website`	Manus Website outputs and WebDev websites, including legacy WebDev outputs without an indexed platform
`mobile_app`	WebDev mobile applications
`game`	WebDev games
`documents`	`pdf`, `doc`, `docx`, `text`, `md`, `mdx`, `txt`
`slides`	Manus Slides and Slide XML outputs
`spreadsheets`	`xlsx`, `xls`, `csv`, `tsv`, `numbers`, `ods`
`images`	`jpg`, `jpeg`, `png`, `gif`, `webp`, `svg`, `bmp`, `heic`, `heif`
`videos`	`mp4`, `avi`, `mov`, `wmv`, `webm`, `mkv`, `m4v`, `mpg`, `mpeg`
`audio`	`mp3`, `wav`, `flac`, `aac`, `ogg`, `wma`, `m4a`, `aiff`, `opus`
`others`	Artifacts outside the categories above

The ten specific categories are mutually exclusive and together cover all for the same indexed data and access scope. Each response item’s type is the category used by the filter; all is only a request value. Classification uses the indexed Library file type and extension, rather than the current filename or platform_type returned with the artifact. Website, WebDev, and Slides classification takes precedence over extension-based categories: a Slides record with a pdf extension remains slides, and a WebDev record with an unrecognized indexed platform extension belongs to others. The format list does not guarantee that an agent can generate every listed format. For example, list generated spreadsheets:

curl 'https://api.manus.ai/v2/artifact.list?type=spreadsheets&limit=20' \
  -H "x-manus-api-key: $MANUS_API_KEY"

An example response containing one matching artifact:

{
  "ok": true,
  "request_id": "request_example",
  "data": [
    {
      "id": "artifact_example",
      "task_id": "task_example",
      "filename": "forecast.xlsx",
      "display_name": "Forecast",
      "type": "spreadsheets",
      "file_type": "file",
      "favorite": false
    }
  ],
  "has_more": false
}

URLs and resources

Downloadable artifacts return url.
Website and WebDev artifacts can return a site URL. An unpublished WebDev artifact can have no URL.
Mobile WebDev artifacts can return an application logo when one is available.
Addon artifacts return resource_uri instead of exposing an internal manus-resource:// value as a download URL.
task_id and credential filters refer to the artifact’s original creation task, not its most recent editing task. Only artifacts with an active creation task owned by the authenticated user are returned; collaboration access alone does not include a task.
Credential IDs come from the creation-time record. Deleting an API key does not erase that ID; its display name may be absent.
source is omitted when no API key or OAuth client ID can be attributed to the creation task. This includes UI-created tasks and API-created tasks without recorded credential IDs. An omitted source does not imply that the task was created in the UI.

Slides conversion is separate from artifact classification. To retrieve Slides attachments as PowerPoint, use task.listMessages with slides_format=pptx.

Pagination and ordering

Results are ordered by creation time descending, with stable identifier tie-breakers. Name searches use the same ordering. Pagination has no 10,000-result offset window. When has_more is true, pass next_cursor to the next request with the same authenticated user, credential scope, filters, and limit. A cursor from another query is rejected. Treat cursors as opaque; restart without a cursor when changing the query. A page may contain fewer than limit artifacts, or even be empty, while has_more is true: deleted, blocked, inaccessible, and duplicate search hits are removed before returning results. Continue until has_more is false. A dependency failure returns an error; retry the same request and cursor rather than advancing. Within one traversal, an artifact is returned at most once by id and by nonempty resource_uri, even when it has projections in several tasks. Retrying a retained cursor replays that page and rechecks current access; apply the replay as a replacement for that page. If combining separate traversals, deduplicate by resource_uri when present, otherwise by id. Cursors expire after 5 minutes without use or 15 minutes from the start of the traversal. Only the latest 3 produced pages remain replayable. Each user can retain up to 32 traversals; opening more evicts the least recently used one. An expired, evicted, or older cursor returns 400 invalid_argument; restart without a cursor. A traversal is limited to 2,000 pages and bounded server state; exceeding capacity returns 429 resource_exhausted, not an end-of-list response. Refine the query before restarting. This is a live list, not a snapshot. New artifacts created after the first page normally appear on a fresh traversal. Changes to an artifact’s sort position or visibility during traversal can change which items are returned. Manus-managed private CDN URLs in url and cover_image pass through the same re-signing path used by Manus Library whenever this endpoint builds a response. A successful re-sign creates a URL with a 48-hour lifetime. Treat signed URLs as temporary and call artifact.list again instead of storing one as a permanent artifact identifier. Re-signing is best-effort: if the signing service is unavailable, the stored URL is returned unchanged and can already be expired. Website URLs do not use this expiry, and Addon artifacts use resource_uri.

Errors

Status / code	When
`400 invalid_argument`	Both credential filters are present, `type` is unsupported, `limit` is outside 1–100, `cursor` is invalid, expired, outside the replay window, or does not match the query.
`403 permission_denied`	An OAuth app with only `create_task` filters by `api_key_id` or another app’s `oauth_client_id`.
`429 resource_exhausted`	The request rate or traversal capacity limit is reached. For traversal capacity, refine the query and restart without a cursor.
`503 unavailable`	Search, source metadata, artifact details, or pagination state are temporarily unavailable. Retry the same cursor.

Headers

x-manus-api-key

string

API key for direct authentication. Provide either this or Authorization, not both.

Authorization

string

OAuth2 access token. Requires create_task or manage_all_tasks unless the client is trusted. Restricted create_task clients are always filtered to their own app, even without explicit source filters; older artifacts without indexed source metadata may be omitted. Provide either this or x-manus-api-key, not both.

Example:

"Bearer {access_token}"

Query Parameters

limit

integer

default:20

Maximum artifacts per page. Pages may be short or empty while has_more is true.

Required range: 1 <= x <= 100

cursor

string

Opaque next_cursor from the previous page. Keep the user, credential scope, filters, and limit unchanged. Continue until has_more is false; IDs and Addon resources are deduplicated across this live traversal. Cursors expire after 5 minutes idle or 15 minutes total. Only the latest 3 produced pages can be replayed; replace that page when retrying. Expired or evicted cursors return 400 invalid_argument. Traversal capacity returns 429 resource_exhausted; refine the query and restart.

name

string

Search the artifact display name.

type

enum<string>

default:all

Filter by indexed Manus Library artifact category. The ten specific categories are mutually exclusive and together cover all for the same indexed data and access scope. Website, WebDev, and Slides classification takes precedence over extension-based categories. Response type uses the same classification.

Available options:

all,

website,

mobile_app,

game,

documents,

slides,

spreadsheets,

images,

videos,

audio,

others

Example:

"spreadsheets"

favorite

boolean

When true, return only favorited artifacts. Omit or pass false for no favorite filter.

oauth_client_id

string

Filter by the Open App that created the source task. Mutually exclusive with api_key_id. Restricted create_task OAuth clients always have this filter applied for their own app and cannot select another app. Older artifacts without indexed source metadata may be omitted, including when this filter is implicit.

api_key_id

string

Filter by the API key that created the source task. Mutually exclusive with oauth_client_id. Unavailable to restricted create_task OAuth clients. Older artifacts without indexed source metadata may be omitted.

Response

Artifacts retrieved successfully.

boolean

Whether the request was successful.

Example:

true

request_id

string

Unique identifier for this API request.

data

object[]

Array of generated artifacts matching the filters.

Hide child attributes

data.id

string

Stable Library file ID.

data.task_id

string

Task that produced the artifact.

data.task_title

string

Current title of the task that produced the artifact.

data.filename

string

Physical filename, including its extension when available.

data.display_name

string

User-facing artifact name shown in Manus Library.

data.type

enum<string>

Indexed Manus Library category used by the request filter. Based on the indexed file type and extension, not recomputed from the current filename or platform_type. Website, WebDev, and Slides classification takes precedence over extension-based categories; unrecognized WebDev platform extensions fall into others.

Available options:

website,

mobile_app,

game,

documents,

slides,

spreadsheets,

images,

videos,

audio,

others

Example:

"spreadsheets"

data.file_type

enum<string>

Underlying Manus SessionFile type.

Available options:

file,

image,

slide,

website,

webdev

data.content_type

string

MIME type inferred from the filename when available.

data.url

string

Download or site URL when the artifact has a public API-consumable URL.

data.cover_image

string

Cover or preview image URL when available.

data.favorite

boolean

Whether the user favorited the artifact in Manus Library.

data.updated_at

integer<int64>

Unix timestamp in seconds.

data.platform_type

integer<int32>

For WebDev artifacts: 1 is Web, 2 is Mobile, and 3 is Game. Treat other values as unknown.

data.logo

string

WebDev application logo. Present for mobile WebDev artifacts when available.

data.resource_uri

string

Addon Resource identity. Returned instead of treating an internal resource URI as a download URL.

data.source

object

Credential attributable to the producing task. Omitted when no API key or OAuth client ID is available; omission does not imply that the task was created in the UI.

Hide child attributes

data.source.kind

enum<string>

Credential type that created the source task.

Available options:

oauth_client,

api_key

data.source.oauth_client_id

string

Open App client ID. Present when kind is oauth_client.

data.source.api_key_id

string

API key ID. Present when kind is api_key.

data.source.name

string

Current credential display name when available.

has_more

boolean

Whether more artifacts are available.

next_cursor

string

Cursor for the next page. Present only when has_more is true.

⌘I

ListArtifacts

curl --request GET \
  --url https://api.manus.ai/v2/artifact.list

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.manus.ai/v2/artifact.list",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.manus.ai/v2/artifact.list"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.manus.ai/v2/artifact.list")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "ok": true,
  "request_id": "<string>",
  "data": [
    {
      "id": "<string>",
      "task_id": "<string>",
      "task_title": "<string>",
      "filename": "<string>",
      "display_name": "<string>",
      "type": "spreadsheets",
      "file_type": "file",
      "content_type": "<string>",
      "url": "<string>",
      "cover_image": "<string>",
      "favorite": true,
      "updated_at": 123,
      "platform_type": 123,
      "logo": "<string>",
      "resource_uri": "<string>",
      "source": {
        "kind": "oauth_client",
        "oauth_client_id": "<string>",
        "api_key_id": "<string>",
        "name": "<string>"
      }
    }
  ],
  "has_more": true,
  "next_cursor": "<string>"
}

{
  "ok": false,
  "request_id": "<string>",
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

{
  "ok": false,
  "request_id": "<string>",
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

{
  "ok": false,
  "request_id": "<string>",
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

Getting Started

API Reference

Filters

Artifact categories

URLs and resources

Errors

Headers

Query Parameters

Response

​Filters

​Artifact categories

​URLs and resources

​Pagination and ordering

​Errors

Headers

Query Parameters

Response

Filters

Artifact categories

URLs and resources

Pagination and ordering

Errors