> ## Documentation Index
> Fetch the complete documentation index at: https://open.manus.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# artifact.list
> Lists generated task artifacts from the authenticated user's Manus Library, newest first. Temporary input files from file.upload are not included. See the [Artifacts](https://open.manus.ai/docs/v2/artifacts) guide.
Questions or issues? Contact us at [api-support@manus.ai](mailto: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](https://open.manus.ai/docs/v2/open-app#task-visibility).
* **Trusted client:** Full access.
**Guide:** Filter rules, artifact categories, URL lifetimes, pagination, and error codes are in the [Artifacts](https://open.manus.ai/docs/v2/artifacts) guide.
## OpenAPI
````yaml GET /v2/artifact.list
openapi: 3.1.0
info:
title: Manus OpenAPI v2
description: >-
API for integrating Manus into your workflow. All responses are wrapped with
{"ok": true, "request_id": "...", ...} for success and {"ok": false,
"request_id": "...", "error": {"code": "...", "message": "..."}} for errors.
version: 2.0.0
servers:
- url: https://api.manus.ai
security:
- ApiKeyAuth: []
paths:
/v2/artifact.list:
get:
summary: ListArtifacts
description: >-
Lists generated task artifacts from the authenticated user's Manus
Library, newest first. Temporary input files from file.upload are not
included. See the [Artifacts](https://open.manus.ai/docs/v2/artifacts)
guide.
operationId: openapi.v2.OpenapiV2Service.ListArtifacts
parameters:
- name: x-manus-api-key
in: header
required: false
schema:
type: string
description: >-
API key for direct authentication. Provide either this or
Authorization, not both.
- name: Authorization
in: header
required: false
schema:
type: string
example: Bearer {access_token}
description: >-
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.
- name: limit
in: query
schema:
type: integer
minimum: 1
maximum: 100
default: 20
description: >-
Maximum artifacts per page. Default 20, maximum 100. A page can be
short or empty while `has_more` is true.
- name: cursor
in: query
schema:
type: string
description: >-
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](https://open.manus.ai/docs/v2/artifacts#pagination-and-ordering).
- name: name
in: query
schema:
type: string
description: >-
Search the artifact display name. Results stay ordered by creation
time.
- name: type
in: query
schema:
type: string
enum:
- all
- website
- mobile_app
- game
- documents
- slides
- spreadsheets
- images
- videos
- audio
- others
default: all
example: spreadsheets
description: >-
Filter by Library category. Default `all`. The ten specific
categories are mutually exclusive. See [Artifact
categories](https://open.manus.ai/docs/v2/artifacts#artifact-categories).
- name: favorite
in: query
schema:
type: boolean
description: >-
When `true`, return only favorited artifacts. Omitted or `false`
applies no favorite filter.
- name: oauth_client_id
in: query
schema:
type: string
description: >-
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](https://open.manus.ai/docs/v2/artifacts#filters).
- name: api_key_id
in: query
schema:
type: string
description: >-
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](https://open.manus.ai/docs/v2/artifacts#filters).
responses:
'200':
description: Artifacts retrieved successfully.
content:
application/json:
schema:
type: object
properties:
ok:
type: boolean
example: true
description: Whether the request was successful.
request_id:
type: string
description: Unique identifier for this API request.
data:
type: array
items:
$ref: '#/components/schemas/Artifact'
description: Array of generated artifacts matching the filters.
has_more:
type: boolean
description: Whether more artifacts are available.
next_cursor:
type: string
description: >-
Cursor for the next page. Present only when has_more is
true.
'503':
description: >-
A search, metadata, or pagination-state dependency is unavailable.
Retry the same request and cursor.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
4XX:
description: Error response.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
5XX:
description: Server error.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
security: []
components:
schemas:
Artifact:
type: object
description: A generated task artifact indexed by Manus Library.
properties:
id:
type: string
description: Stable Library file ID.
task_id:
type: string
description: Task that produced the artifact.
task_title:
type: string
description: Current title of the task that produced the artifact.
filename:
type: string
description: Physical filename, including its extension when available.
display_name:
type: string
description: User-facing artifact name shown in Manus Library.
type:
type: string
enum:
- website
- mobile_app
- game
- documents
- slides
- spreadsheets
- images
- videos
- audio
- others
description: >-
Library category, as used by the `type` filter. Based on the indexed
file type and extension. See [Artifact
categories](https://open.manus.ai/docs/v2/artifacts#artifact-categories).
example: spreadsheets
file_type:
type: string
enum:
- file
- image
- slide
- website
- webdev
description: Underlying Manus SessionFile type.
content_type:
type: string
description: MIME type inferred from the filename when available.
url:
type: string
description: >-
Download or site URL when the artifact has a public API-consumable
URL.
cover_image:
type: string
description: Cover or preview image URL when available.
favorite:
type: boolean
description: Whether the user favorited the artifact in Manus Library.
updated_at:
type: integer
format: int64
description: Unix timestamp in seconds.
platform_type:
type: integer
format: int32
description: |-
WebDev platform.
- `1` — Web.
- `2` — Mobile.
- `3` — Game.
Treat other values as unknown.
logo:
type: string
description: >-
WebDev application logo. Present for mobile WebDev artifacts when
available.
resource_uri:
type: string
description: >-
Addon Resource identity. Returned instead of treating an internal
resource URI as a download URL.
source:
$ref: '#/components/schemas/ArtifactSource'
description: >-
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.
ErrorResponse:
type: object
description: Standard error response format returned when a request fails.
properties:
ok:
type: boolean
example: false
description: Always false for error responses.
request_id:
type: string
description: >-
Unique identifier for this API request, useful for debugging with
support.
error:
type: object
description: Error details.
properties:
code:
type: string
description: >-
Machine-readable error code (e.g., "invalid_argument",
"not_found", "permission_denied", "rate_limited").
message:
type: string
description: Human-readable error description explaining what went wrong.
ArtifactSource:
type: object
description: >-
Credential attributable to the artifact's creation task. Omitted when no
API key or OAuth client ID is available, including UI-created tasks and
API-created tasks without recorded credential IDs.
properties:
kind:
type: string
enum:
- oauth_client
- api_key
description: Credential type that created the source task.
oauth_client_id:
type: string
description: Open App client ID. Present when kind is oauth_client.
api_key_id:
type: string
description: API key ID. Present when kind is api_key.
name:
type: string
description: Current credential display name when available.
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: x-manus-api-key
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.