---
title: "Ask a question the wizard has built"
method: POST
path: "/workspaces/{id}/questions/{questionId}/asking/finish"
tags: ["questions"]
---

# Ask a question the wizard has built

`POST /workspaces/{id}/questions/{questionId}/asking/finish`

## Request

- Base URL: `https://api.swingfactor.ai/v1`
- URL: `https://api.swingfactor.ai/v1/workspaces/{id}/questions/{questionId}/asking/finish`
- Auth: HTTP bearer

It leaves the wizard: it can be drafted, and a public one is read by anybody signed in. Asking one asked already changes nothing.

## Path parameters

- `id` string, uuid, required
- `questionId` string, uuid, required

## Response `200`

The question, asked.

- Question
  - `id` string, uuid, required
  - `workspaceId` string, uuid, required
  - `createdBy` string, uuid
  - `title` string, required
  - `framing` string
  - `visibility` 'public' | 'private', required: Public is readable by anybody signed in; private by the workspace alone.
  - `evidenceCutoff` string: The evidence cut-off, YYYY-MM-DD: what came after it is listed apart.
  - `constraintKind` 'time' | 'money' | 'people' | 'access' | 'deadline': What limits the investigation. Only with one may a person prioritise the open matters.
  - `constraintNote` string
  - `constraintDeadline` string: For a deadline: YYYY-MM-DD.
  - `availability` 'engaged' | 'not-material': engaged: whether each option could be had and kept is examined here; not-material: the question raises no material availability issue. Absent: not stated.
  - `scenariosStated` 'none': none: the question says no scenarios apply. Absent: not stated.
  - `depth` 'standard' | 'full', required: standard or full: what is shown up front and what a draft proposes.
  - `askingStep` 'options' | 'scenarios' | 'dimensions' | 'sources' | 'view' | 'ask': Still being asked: the furthest step the wizard reached. Its workspace’s alone, and not drafted, until it is asked. Absent once asked.
  - `createdAt` string, required
  - `updatedAt` string, required
  - `links` QuestionLinks, required: Relative /v1 URLs to follow.
    - `self` string, required
    - `options` string, required
    - `propositions` string, required
    - `evidence` string, required
    - `dependencies` string, required
    - `variables` string, required
    - `investigation` string, required
    - `challenges` string, required
    - `history` string, required
    - `bearings` string, required
    - `symmetry` string, required
    - `briefing` string, required
    - `snapshots` string, required
    - `sources` string, required
    - `workspace` string, required

## Other responses

- `401`: No token, or not a valid one: `unauthorized`.
- `404`: No such question.
- `422`: Fewer than two options: `options_required`.

---

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