---
title: "List Root Contents"
method: GET
path: "/api/v1/quick-spaces/folders/contents"
tags: ["quickSpaces", "quickSpaces"]
---

# List Root Contents

`GET /api/v1/quick-spaces/folders/contents`

The ROOT level of a scope — the files that sit in no folder, plus the top-level folders.
Declared before /folders/{folder_id} so "contents" can't be read as a folder id.

## Query parameters

- `space_id` string, nullable
- `type` string, nullable
- `q` string, nullable

## Response `200`

Successful Response

- SpaceFolderContentsResponseDTO — One level of a space's file tree: where we are, how we got here, and what's inside.
  - `folder` SpaceFolderResponseDTO
    - `id` string, required
    - `name` string, required
    - `space_id` string, nullable
    - `space_title` string, nullable
    - `parent_id` string, nullable
    - `created_at` string, date-time, required
    - `folder_count` integer
    - `asset_count` integer
  - `breadcrumb` SpaceFolderResponseDTO[]
    - `id` string, required
    - `name` string, required
    - `space_id` string, nullable
    - `space_title` string, nullable
    - `parent_id` string, nullable
    - `created_at` string, date-time, required
    - `folder_count` integer
    - `asset_count` integer
  - `folders` SpaceFolderResponseDTO[]
    - `id` string, required
    - `name` string, required
    - `space_id` string, nullable
    - `space_title` string, nullable
    - `parent_id` string, nullable
    - `created_at` string, date-time, required
    - `folder_count` integer
    - `asset_count` integer
  - `assets` SpaceAssetResponseDTO[]
    - `id` string, required
    - `url` string, required
    - `type` string, required
    - `tags` string[], nullable
    - `version` integer, required
    - `status` string
    - `name` string, nullable
    - `created_at` string, date-time, required
    - `comment_count` integer
    - `version_count` integer
    - `space_id` string, nullable
    - `space_title` string, nullable
    - `folder_id` string, nullable
    - `ai_metadata` AiMetadataDTO — AI-provenance verdict for one creative. state: present | removed | clean | unknown. `unknown` means "not inspected", which is NOT the same claim as `clean` ("inspected, nothing found") and must never be rendered as one.
      - `state` string
      - `markers` string[]
      - `checked_at` string, nullable
      - `removed_at` string, nullable
    - `disclaimer` DisclaimerStateDTO — Whether this creative's burned-in AI disclosure is switched on, and what it says. `enabled` is the toggle; `applied` is whether a disclosed rendition exists to switch on at all. Both are needed: a creative that has never been disclosed and one whose disclosure is currently off look identical without them.
      - `applied` boolean
      - `enabled` boolean
      - `original_url` string, nullable
      - `template` object, nullable
      - `text` string, nullable
      - `template_name` string, nullable
      - `applied_at` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/brandbooster/apis/fastapi.md) · [All operations](https://skmtc.dev/brandbooster/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/brandbooster/fastapi/revisions/ff7f2b621b41/schema)