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

## Changes

- **2026-08-08** `ef761849166b` — 2 warning
  - added the new `app` enum value to the `assets/items/entityType` response property for the response status `200`
  - added the new `script` enum value to the `assets/items/entityType` response property for the response status `200`
- **2026-08-07** `06cac6a7c5bc` — 2 info
  - added the media type `application/json` for the response with the status `200`
  - added the media type `application/json` for the response with the status `400`
- **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/e0acd2155cad/schema)