---
title: "Ask your workspace (single-turn Q&A)"
method: POST
path: "/v1/ask"
tags: ["Search"]
---

# Ask your workspace (single-turn Q&A)

`POST /v1/ask`

Read-only answer over pages the caller can access. Same access scope as search. Triggered from Home Cmd+K when the query ends with `?`.

## Request body

- object
  - `question` string, required
  - `workspace` string — Workspace id to scope (optional for personal context).

## Response `200`

Answer with page citations

- object
  - `answer` string
  - `citations` object[]
    - `artifact_id` string
    - `title` string
    - `url` string

## Other responses

- `401` — Authentication required

---

[API](https://skmtc.net/shareout/apis/shareout-rest-api.md) · [All operations](https://skmtc.net/shareout/apis/shareout-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shareout/shareout-rest-api/revisions/804359ead65a/schema)