---
title: "Ask Conversations"
method: POST
path: "/v1/dev/user/ask"
tags: ["Conversations"]
---

# Ask Conversations

`POST /v1/dev/user/ask`

Answer a natural-language question grounded in the user's own conversations.

Semantically searches the user's conversations for the question, then synthesizes a
cited answer from the most relevant ones — the same retrieval + RAG the chat surface
uses, exposed for headless / Developer-API callers (CLI, CI, scripts). Read-only:
it never writes; discarded conversations are excluded from retrieval and locked
conversations are re-checked on the authoritative record before any go to the LLM.

## Request body

- DeveloperAskRequest
  - `limit` integer — How many of the most relevant conversations to ground the answer on
  - `question` string, required — A natural-language question about the user's life/conversations
  - `timezone` string — IANA timezone used to resolve relative dates in the answer

## Response `200`

Successful Response

- DeveloperAskResponse
  - `answer` string, required
  - `sources` DeveloperAskSource[], required
    - `created_at` string, date-time, nullable
    - `id` string, required
    - `title` string, required

## Other responses

- `401` — Missing or invalid authentication credentials.
- `403` — Authenticated, but the token does not grant the required scope.
- `422` — Validation Error

---

[API](https://skmtc.dev/basedhardware/apis/omi-developer-api.md) · [All operations](https://skmtc.dev/basedhardware/apis/omi-developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/basedhardware/omi-developer-api/revisions/3add0ce9bc4f/schema)