---
title: "Ask Ai 2"
method: POST
path: "/ask_ai_2"
---

# Ask Ai 2

`POST /ask_ai_2`

## Request

- Base URL: `https://api.yomu.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.yomu.ai/ask_ai_2`
- Auth: API key in header `ACCESS_TOKEN`

Ask Yomu using live TipTap nodes instead of flattened document text.

## Request body

- AskText2Request: Node-addressed Ask Yomu request. The client sends a complete, live TipTap node snapshot and references the selected text through node IDs plus UTF-16 offsets. This deliberately does not accept the legacy flattened ``text`` / ``full_text`` fields.
  - `prompt` string, required
  - `nodes` AgentChatNode[]
    - `id` string, required
    - `type` string, required
    - `index` integer, required
    - `typeIndex` integer, required
    - `text` string, required
    - `marks` AgentChatNodeMark[], nullable
      - `mark` 'bold' | 'italic' | 'strike' | 'underline' | 'code', required
      - `text` string, required
  - `target_nodes` AskAi2TargetNode[]
    - `id` string, required
    - `from_offset` integer, required
    - `to_offset` integer, required
  - `generated_text` string, nullable
  - `plan` string, nullable
  - `prefer_gpt` string, nullable
  - `custom_style` string, nullable
  - `language` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

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