---
title: "Ask Ava"
method: POST
path: "/ava/v1/askSync"
tags: ["Ava"]
---

# Ask Ava

`POST /ava/v1/askSync`

Send a question to Ava and receive a synchronous response.
Set `ephemeral` to `true` to skip conversation persistence (recommended for programmatic consumers).
When `ephemeral` is `false` (default), the response includes a `conversationId` that can be used with the delete endpoint.

## Request body

- AvaAskSyncRequest
  - `question` string, required — The question to ask Ava.
  - `conversationId` string — Optional ID of an existing conversation to continue.
  - `ephemeral` boolean — When true, the conversation is not persisted. Recommended for programmatic consumers (Terraform, MCP, CI pipelines).

## Response `200`

OK - Ava response returned.

- AvaAskSyncResponse — Ava's response. On success, `answer` is present. The endpoint streams keep-alive whitespace while generating (to avoid proxy timeouts), so the HTTP status is committed to 200 before the answer is ready; if generation then fails, `answer` is omitted and `error` carries a message instead. Consumers should check for `error` before reading `answer`.
  - `answer` string — The Ava response text. Present on success.
  - `conversationId` string — The conversation ID. Present only for non-ephemeral requests. Can be used with the delete conversation endpoint.
  - `answerId` string — The answer ID within the conversation. Present only for non-ephemeral requests. Required for the feedback endpoint.
  - `error` string — Present instead of `answer` when generation fails after the response has begun streaming (the HTTP status remains 200). A human-readable error message.

## Other responses

- `400` — Bad Request - The server cannot process the request, often due to a malformed request.
- `401` — Unauthorized - Invalid API key.
- `403` — Forbidden - The client is not authorized to perform the request.
- `500` — Internal Server Error - Something went wrong with the DoiT API server.

---

[API](https://skmtc.dev/doit/apis/doit-cloud-intelligence.md) · [All operations](https://skmtc.dev/doit/apis/doit-cloud-intelligence/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/doit/doit-cloud-intelligence/revisions/9416402fc119/schema)