---
title: "List all assets"
method: GET
path: "/assets"
tags: ["Assets"]
---

# List all assets

`GET /assets`

## Request

- Base URL: `https://enterprise.knak.io/api/published/v1`
- URL: `https://enterprise.knak.io/api/published/v1/assets`
- Auth: none declared
- TypeScript: <https://skmtc.dev/knak/apis/knak-enterprise-api/docs/assets/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve all [assets](#tag/asset_model)  in organization.

## Query parameters

- `page` integer
- `per_page` integer
- `filter[parent_asset_id]` string
- `filter[approval_status]` 'draft' | 'review' | 'rejected' | 'approved' | 'completed'

## Response `200`

OK

- AssetList
  - `data` Asset[]
    - `type` string, required
    - `id` string, required
    - `attributes` object, required
      - `id` string, required
      - `creator_id` string, required
      - `subject` string, required
      - `from_name` string, nullable, required
      - `from_email` string, nullable, required
      - `reply_email` string, nullable, required
      - `type` 'email' | 'landing', required
      - `name` string, required
      - `folder_path` string, required
      - `campaign` string, required
      - `brand` string, required
      - `language_code` string, nullable, required
      - `version` string, required
      - `parent_asset_id` string, nullable, required
      - `ai_generation_status` 'started' | 'completed' | 'failed', nullable: Status of AI content generation. Only present on assets created via the /assets/generate endpoint. Null for non-AI assets.
      - `ai_generation_error` string, nullable: Why AI content generation failed, when `ai_generation_status` is `failed` (for example, an image URL in the prompt that could not be accessed). Null otherwise.
      - `deleted` boolean: Whether the asset has been deleted. Only true for an asset whose AI generation failed in the last 3 days; other deleted assets return 404.
      - `approval_status` 'draft' | 'review' | 'rejected' | 'approved' | 'completed', nullable, required: Where the asset is in your company's approval workflow.
  - `links` object
    - `first` string
    - `last` string
    - `prev` string, nullable
    - `next` string, nullable
  - `meta` object
    - `current_page` integer
    - `from` integer
    - `last_page` integer
    - `links` object[]
      - `url` string, nullable
      - `label` string
      - `active` boolean
    - `path` string
    - `per_page` integer
    - `to` integer
    - `total` integer

## Other responses

- `400`: Bad Request - `filter[approval_status]` is not one of the allowed values.
- `401`: Unauthenticated
- `403`: Unauthorized

---

[API](https://skmtc.dev/knak/apis/knak-enterprise-api.md) - [All operations](https://skmtc.dev/knak/apis/knak-enterprise-api/llms.txt) - [OpenAPI document](https://skmtc.dev/knak/apis/knak-enterprise-api/revisions/31d2c94edfcc?raw)