---
title: "Admin Shares"
method: GET
path: "/api/v1/quick-spaces/admin/shares"
tags: ["quickSpaces", "quickSpaces"]
---

# Admin Shares

`GET /api/v1/quick-spaces/admin/shares`

## Query parameters

- `start` string, nullable — YYYY-MM-DD, inclusive, UTC
- `end` string, nullable — YYYY-MM-DD, inclusive, UTC
- `search` string, nullable — matches title, creator or id
- `sort` string, nullable — any column on the row; default created_at
- `order` string, nullable — asc | desc (default desc)
- `page` integer
- `page_size` integer

## Headers

- `X-Admin-Session` string, nullable

## Response `200`

Successful Response

- AdminSharesResponseDTO
  - `range` AdminRangeDTO, required — The window every number on the response was computed over. Inclusive on both ends, UTC.
    - `start` string, date, required
    - `end` string, date, required
    - `days` integer
  - `rows` AdminShareRowDTO[]
    - `id` string, required
    - `title` string
    - `created_at` string, date-time, nullable
    - `created_by` AdminUserRefDTO — A person named from another object — a project's assignee, a creative's uploader, a share link's owner. Identity only; every productivity number about them lives on their own row. Present as an object rather than a bare id because the two identity tables mean an id alone is not resolvable by the client: a monolith UUID and a Spaces 32-char hex look the same in JSON and only the server knows which directory to look in.
      - `user_id` string
      - `name` string
      - `email` string
      - `role` string
    - `enabled` boolean
    - `expires_at` string, date-time, nullable
    - `watermark` boolean
    - `password_protected` boolean
    - `downloads_allowed` boolean
    - `folder_backed` boolean
    - `assets` integer
    - `views` integer
    - `downloads` integer
    - `comments` integer
    - `last_activity_at` string, date-time, nullable
  - `total` integer
  - `page` integer
  - `page_size` integer
  - `adoption` AdminAdoptionDTO — Share-link hygiene, as a percentage of the links created in the window. `links` is the denominator and is published alongside the percentages on purpose: 100% of two links is not the same fact as 100% of two hundred, and a card that shows only the percentage invites the reader to confuse them.
    - `links` integer
    - `watermark_pct` number
    - `password_pct` number
    - `expiry_pct` number
    - `downloads_enabled_pct` number
    - `folder_backed` integer

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-02** `ff7f2b621b41` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/brandbooster/apis/fastapi/changes/api/v1/quick-spaces/admin/shares/get.md)

---

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