---
title: "List lightweight cross-entity asset summaries"
method: GET
path: "/api/assets"
tags: ["Assets"]
---

# List lightweight cross-entity asset summaries

`GET /api/assets`

Returns only entity type, ID, namespace key, label, update time, and optional provider reference. It never returns task briefs, page bodies, workflow definitions, secrets, or file bytes. Personal keys are namespace labels, not a privacy or read-visibility guarantee.

## Query parameters

- `keyPrefix` string — Non-unique asset directory namespace (for example shared/ or personal/<user-id>/drafts/). Runtime write boundaries normalize and validate the canonical form.
- `types` string — Comma-separated task,workflow,schedule,page,file list
- `limit` integer

## Response `200`

Lightweight asset summary list

## Other responses

- `400` — Invalid entity type

## Changes

- **2026-07-11** `f1022d5edb0d` — 1 info
  - endpoint added
- **2026-07-02** `0c910612f9ac` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/changes/api/assets/get.md)

---

[API](https://skmtc.dev/desplega-ai/apis/agent-swarm-api.md) · [All operations](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/desplega-ai/agent-swarm-api/revisions/92a1dcbd2fc7/schema)