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

# Admin Shares

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

## Request

- Base URL: `https://api.brandbooster.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.brandbooster.ai/api/v1/quick-spaces/admin/shares`
- Auth: none declared

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

> 36 revisions in range; 1 not diffed.

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

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

---

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