---
title: "Ai Search Follow Up Endpoint"
method: POST
path: "/api/v1/remy/ai-search/{search_id}/follow-up"
tags: ["remy", "remy"]
---

# Ai Search Follow Up Endpoint

`POST /api/v1/remy/ai-search/{search_id}/follow-up`

Refine a completed AI Search session without discarding its existing filters.

## Path parameters

- `search_id` string, required

## Request body

- AiSearchFollowUpRequestDTO
  - `query` string, required
  - `platforms` string[], nullable
  - `size` 'under_10k' | '10k_100k' | '100k_500k' | '500k_1m' | '1m_plus' — The UI's Size selector. Values are FOLLOWER_BAND_BOUNDS keys, not tier names — the tier vocabulary (Nano/Micro/Mid/Macro) bands differently and would mis-filter against them.
  - `depth` 'quick' | 'balanced' | 'deep' — How many candidates the scoring pass reads — the UI's Depth selector.
  - `live_content` boolean
  - `jobs` string[], nullable

## Response `200`

Successful Response

- AiSearchStartedDTO
  - `job_id` string, nullable
  - `search_id` string, required
  - `status` string, required
  - `message` string, nullable
  - `questions` AiSearchClarificationQuestionDTO[]
    - `id` string, required
    - `question` string, required
    - `options` AiSearchClarificationOptionDTO[]
      - `label` string, required
      - `value` string, required
    - `allow_multiple` boolean
    - `allow_free_text` boolean
    - `required` boolean
  - `can_skip` boolean

## Other responses

- `422` — Validation Error

## Changes

> 15 revisions in range; 1 not diffed.

- **2026-09-16** `dda5cf04b73d` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/brandbooster/apis/fastapi/changes/api/v1/remy/ai-search/:search_id/follow-up/post.md)

---

[API](https://skmtc.dev/brandbooster/apis/fastapi.md) · [All operations](https://skmtc.dev/brandbooster/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc.dev/brandbooster/apis/fastapi/revisions/7ba0627b6b4c?raw)