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.}

Auth:

API Key: Full access.
Standard OAuth client: Requires create_task or manage_all_tasks. With create_task, only artifacts from tasks created by the same client; see Task visibility.
Trusted client: Full access.

Guide: Filter rules, artifact categories, URL lifetimes, pagination, and error codes are in the Artifacts guide.

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. Default 20, maximum 100. A page can be short or empty while has_more is true.

Required range: 1 <= x <= 100

cursor

string

Opaque next_cursor from the previous page. Omit for the first page.

Keep the user, credential scope, filters, and limit unchanged.
Continue until has_more is false.
Cursors expire after 5 minutes idle or 15 minutes total; an expired cursor returns 400 invalid_argument. Restart without a cursor.

See Pagination and ordering.

name

string

Search the artifact display name. Results stay ordered by creation time.

type

enum<string>

default:all

Filter by Library category. Default all. The ten specific categories are mutually exclusive. See Artifact categories.

Available options:

all,

website,

mobile_app,

game,

documents,

slides,

spreadsheets,

images,

videos,

audio,

others

Example:

"spreadsheets"

favorite

boolean

When true, return only favorited artifacts. Omitted or false applies no favorite filter.

oauth_client_id

string

Return only artifacts from tasks created by this Open App. Mutually exclusive with api_key_id; passing both returns 400 invalid_argument.

API Key or Trusted client: any client ID.
Standard OAuth client: any client ID with manage_all_tasks; always filtered to its own app with create_task, and another ID returns 403 permission_denied.

Older artifacts without indexed source metadata may be omitted. See Filters.

api_key_id

string

Return only artifacts from tasks created by this API key. Mutually exclusive with oauth_client_id; passing both returns 400 invalid_argument.

API Key or Trusted client: any key ID.
Standard OAuth client: any key ID with manage_all_tasks; not available with create_task only, which returns 403 permission_denied.

Older artifacts without indexed source metadata may be omitted. See Filters.

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>

Library category, as used by the type filter. Based on the indexed file type and extension. See Artifact categories.

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>

WebDev platform.

1 — Web.
2 — Mobile.
3 — 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

Headers

Query Parameters

Response