---
title: "Put Route Suggestion Pool"
method: POST
path: "/route-suggestion-pools"
tags: ["route-suggestion-pools"]
---

# Put Route Suggestion Pool

`POST /route-suggestion-pools`

Upsert the pool under its cache key with native Valkey expiry.

## Headers

- `x-revalidate-secret` string, nullable

## Request body

- RouteSuggestionPoolWrite — Upsert payload — mirrors looking-glass's ``RouteSuggestionStore.put``.
  - `key` string, required
  - `cards` object[], required
  - `model` string, required
  - `ttl_seconds` integer, required

## Response `204`

Successful Response

## Other responses

- `422` — Validation Error

---

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