---
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,app,script,file list
- `limit` integer

## Response `200`

Lightweight asset summary list

- object
  - `assets` AssetSummary[], required
    - `entityType` 'task' | 'workflow' | 'schedule' | 'page' | 'app' | 'script' | 'file', required
    - `id` string, required
    - `key` string, required — Non-unique asset directory namespace (for example shared/ or personal/<user-id>/drafts/). Runtime write boundaries normalize and validate the canonical form.
    - `label` string, required
    - `updatedAt` string, required
    - `providerRef` AssetProviderRef
      - `providerId` string, required
      - `orgId` string
      - `driveId` string
      - `providerKey` string, required
  - `count` integer, required

## Other responses

- `400` — Invalid entity type

---

[API](https://skmtc.net/desplega-ai/apis/agent-swarm-api.md) · [All operations](https://skmtc.net/desplega-ai/apis/agent-swarm-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/desplega-ai/agent-swarm-api/versions/ef761849166b/schema)