---
name: ai-routes
description: Handle 4 OpenAPI operation(s) under /ai for the ai route group.
---

# ai API Routes

Handle 4 OpenAPI operation(s) under /ai for the ai route group.

Use the generated operation tools to make real API calls. Do not invent API responses.
If a tool reports missing setup, return the exact setup field name to the caller.
For write, update, or delete operations, state the intended action before calling the tool.

## Operations

### post_ai_ask

- Operation ID: `post_ai_ask`
- Route: `POST /ai/ask`
- Mode: WRITE
- Summary: Ask question
- Body: JSON request body accepted.

### post_ai_text_gen

- Operation ID: `post_ai_text_gen`
- Route: `POST /ai/text_gen`
- Mode: WRITE
- Summary: Generate text
- Body: JSON request body accepted.

### post_ai_extract

- Operation ID: `post_ai_extract`
- Route: `POST /ai/extract`
- Mode: WRITE
- Summary: Extract metadata (freeform)
- Body: JSON request body accepted.

### post_ai_extract_structured

- Operation ID: `post_ai_extract_structured`
- Route: `POST /ai/extract_structured`
- Mode: WRITE
- Summary: Extract metadata (structured)
- Body: JSON request body accepted.