---
title: "Generate Neighbourhood Guide"
method: POST
path: "/api/v1/admin/guides/generate"
tags: ["admin"]
---

# Generate Neighbourhood Guide

`POST /api/v1/admin/guides/generate`

## Request

- Base URL: `https://yondry.app` (the document declares no server; this is the origin it was published from)
- URL: `https://yondry.app/api/v1/admin/guides/generate`
- Auth: none declared

Generate (or regenerate) a neighbourhood guide and persist it.

Offline content step only — never called from a live planner/MCP request path.
Google Places resolves each of `place_queries` for real coordinates/hours/rating
first; Claude is only given that verified list and writes copy about it, never
free-standing facts. Any query that doesn't resolve, or that Claude doesn't
write a "why" for, is dropped rather than guessed at.

## Headers

- `X-Admin-Key` string, nullable

## Request body

- GenerateGuideRequest
  - `name` string, required
  - `city` string, required
  - `lat` number, required
  - `lon` number, required
  - `place_queries` string[], required
  - `radius_m` number

## Response `200`

Successful Response

- GenerateGuideResponse
  - `slug` string, required
  - `name` string, required
  - `city` string, required
  - `highlight_count` integer, required
  - `dropped_count` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/yondry/apis/yondry-api.md) · [All operations](https://skmtc.dev/yondry/apis/yondry-api/llms.txt) · [OpenAPI document](https://skmtc.dev/yondry/apis/yondry-api/revisions/d2c213cea95b?raw)