---
title: "POST /api/v0/ai/parts/replacements"
method: POST
path: "/api/v0/ai/parts/replacements"
tags: ["AI"]
---

# POST /api/v0/ai/parts/replacements

`POST /api/v0/ai/parts/replacements`

Semantic search for replacement parts.
Supports pagination query parameters.

A specialized AI agent will search for replacement parts based on the provided datasheet.

## Query parameters

- `#/components/schemas/PartSearchQueryV0` PartSearchQueryV0
  - `q` string, required — Search term
  - `invalidate_cache` boolean — Invalidate cached AI-generated queries
  - `store_query` boolean — Store the generated query. Results can be retrieved again using /ai/parts/search/<request_id>.
  - `cursor` string — Cursor for pagination. Must be a valid base64 string obtained from the pagination.nextCursor field of a previous response.
  - `limit` number — Limit for pagination

## Response `200`

Successful response

- PartsResponseV0
  - `results` object[], required — The results on this page.
    - `id` string, required — The ID of the part.
    - `summary` string, required — A brief summary of the part.
    - `rank` number — The relevance of the part to the search term. Higher values indicate a better match.
  - `pagination` object, required
    - `nextCursor` string, nullable, required — The cursor for getting the next page of results. If null, there are no more results.
    - `totalCount` number, required — The total number of results.
  - `requestId` string, required — The unique identifier for this request.

## Other responses

- `400` — Bad request
- `500` — Internal server error

---

[API](https://skmtc.dev/stillwind/apis/stillwind-api.md) · [All operations](https://skmtc.dev/stillwind/apis/stillwind-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/stillwind/stillwind-api/revisions/8465f5025fdf/schema)