questions

Ask a question the wizard has built

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

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

Path parameters

idstring uuid required

The workspace's id (a UUID).

questionIdstring uuid required

The question's id (a UUID).

Response

The question, asked.

idstring uuid required
workspaceIdstring uuid required
createdBystring uuid
titlestring required
framingstring
visibility'public' | 'private' required

Public is readable by anybody signed in; private by the workspace alone.

evidenceCutoffstring

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.

constraintNotestring
constraintDeadlinestring

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.

createdAtstring required
updatedAtstring required

Example response

{
  "title": "What would Scottish independence actually change?"
}

Changes

No recorded changes to this operation across all 1 revision of this API.