---
title: "Record a palette search"
method: POST
path: "/v1/home/recent-searches"
tags: ["Home", "Search"]
---

# Record a palette search

`POST /v1/home/recent-searches`

## Request

- Base URL: `https://shareout.site`
- URL: `https://shareout.site/v1/home/recent-searches`
- Auth: HTTP bearer

Records `q` as the newest search. A repeat (any case or accents) moves to the top; the list keeps 20.

## Request body

- object
  - `q` string, required

## Response `200`

The recent searches in the scope, newest first

- object
  - `searches` object[]
    - `q` string
    - `at` string, date-time

## Other responses

- `400`: Invalid request
- `401`: Authentication required

## Changes

- **2026-10-17** `08f935e1d035`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/shareout/apis/shareout-rest-api/changes/v1/home/recent-searches/post.md)

---

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