> ## Documentation Index
> Fetch the complete documentation index at: https://docs.havincy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List assets

Lists media in the Havincy library, newest first: images, videos, voice, music, 3D and uploads.

Required permission: `read`. MCP tool: `list_assets`.

<ParamField query="kind" type="string">
  `image`, `video`, `voice`, `music`, `audio`, `model3d` or `upload`.
</ParamField>

<ParamField query="status" type="string">
  `queued`, `processing`, `completed` or `failed`.
</ParamField>

<ParamField query="query" type="string">
  Search in title and prompt.
</ParamField>

<ParamField query="project_id" type="integer">
  Only the media of this project.
</ParamField>

<ParamField query="limit" type="integer" default="20">
  Page size (1 to 50).
</ParamField>

<ParamField query="starting_after" type="integer">
  Cursor: the `next_cursor` of the previous page.
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "object": "list",
    "data": [
      { "id": 5678, "object": "asset", "kind": "image", "status": "completed", "url": "https://havincy.com/rails/active_storage/blobs/proxy/.../image.png" }
    ],
    "has_more": true,
    "next_cursor": 5678
  }
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.