---
title: "Ask the guided onboarding assistant a question"
method: POST
path: "/v1/onboarding/guided/ask"
tags: ["Organization"]
---

# Ask the guided onboarding assistant a question

`POST /v1/onboarding/guided/ask`

## Request

- Base URL: `https://api.1claw.co`
- URL: `https://api.1claw.co/v1/onboarding/guided/ask`
- Auth: HTTP bearer

Scoped, one-shot Q&A for the guided wizard's "have a question?" panel.
Not tied to an agent (many questions arrive before one exists yet) and
not persisted as a conversation. The system prompt is fixed server-side
and refuses anything outside vaults/policies/runtimes/billing/channels —
never client-suppliable. Billed like any other Shroud LLM call: the
caller's own bearer token is forwarded so usage attributes to their org.

## Request body

- GuidedAskRequest
  - `question` string, required
  - `step` integer: Accepted but not yet used to tailor the answer; reserved for later.

## Response `200`

Assistant's answer

- GuidedAskResponse
  - `answer` string, required

---

[API](https://skmtc.dev/1claw/apis/1claw-api.md) · [All operations](https://skmtc.dev/1claw/apis/1claw-api/llms.txt) · [OpenAPI document](https://skmtc.dev/1claw/apis/1claw-api/revisions/5fa0918f3b41?raw)