---
title: "Upsert Collection"
method: POST
path: "/admin/collections"
tags: ["admin"]
---

# Upsert Collection

`POST /admin/collections`

## Request

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

Create (or update, keyed on ``public_slug``) a featured collection.

## Headers

- `x-admin-secret` string, nullable

## Request body

- UpsertCollectionRequest
  - `vertical` string, required
  - `public_slug` string, required
  - `title` string, required
  - `subtitle` string, nullable
  - `region` string, nullable
  - `featured_rank` integer
  - `name` string, nullable

## Response `201`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

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