---
title: "History Request"
method: POST
path: "/api/v1/index/searches/history"
---

# History Request

`POST /api/v1/index/searches/history`

## Request

- Base URL: `https://api.usesynth.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.usesynth.ai/api/v1/index/searches/history`
- Auth: none declared

Retained history list/delete; content is customer-only and keyed.

See notes/specifications/sdk/customer_api_adoption.md, retained
history. Private filter text arrives only in the typed body.

## Query parameters

- `search_id` string, nullable

## Response `200`

Successful Response

- SearchHistoryPage
  - `metadata` ResponseMetadata, required
    - `contract` 'index.v1' | 'swarms.v1' | 'core.v1', required
    - `request_id` string, required
    - `operation_id` string, nullable, required
    - `observed_at` string, date-time, required
    - `server_timing` TimingSpan[]
      - `name` 'request' | 'queue' | 'first_useful' | 'active' | 'wall' | 'settlement', required
      - `duration_ms` number, nullable, required
      - `source` 'server' | 'worker' | 'unknown', required
      - `clock` 'monotonic' | 'utc' | 'unknown', required
      - `uncertainty_ms` number, nullable, required
    - `client_timing` ClientTiming
      - `total_ms` number, required
      - `first_byte_ms` number, required
      - `attempts` integer, required
      - `source` 'sdk_monotonic'
  - `items` SearchHistoryEntry[], required
    - `search_id` string, required
    - `query` string, required
    - `mode` 'fast' | 'deep', required
    - `created_at` string, date-time, required
    - `archive_digest_sha256` string, required
    - `retention` SearchRetention, required: Tolerant retention observation: every field is optional. Older backends send ``policy_version``/``purpose``/``archived_at``/ ``content_expires_at``/``retention_days``/``history_available``; newer ones add ``purges_at`` (zdr) and ``expires_at`` (retained). Absent fields are ``None``.
      - `mode` 'zdr' | 'zdr_strict' | 'retained', nullable
      - `policy_version` string, nullable
      - `purpose` 'customer_only', nullable
      - `content_state` string, nullable
      - `archived_at` string, date-time, nullable
      - `content_expires_at` string, date-time, nullable
      - `purges_at` string, date-time, nullable
      - `expires_at` string, date-time, nullable
      - `retention_days` 30, nullable
      - `history_available` boolean
  - `next_cursor` string, nullable, required
  - `complete` boolean, required
  - `filter` SearchHistoryFilter, required
    - `query` string
    - `created_after` string, date-time, nullable
    - `created_before` string, date-time, nullable

## Other responses

- `422`: Validation Error

---

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