questions

Save a step of asking a question

Each part sent is set whole — the options listed are the options, and one left out is deleted — through the same checks as one at a time. A refusal leaves the step as it was.

put/workspaces/{id}/questions/{questionId}/asking

Request

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

Path parameters

idstring uuid required

The workspace's id (a UUID).

questionIdstring uuid required

The question's id (a UUID).

Request body

titlestring
framingstring
visibility'public' | 'private'

Defaults from the plan.

depth'standard' | 'full'

standard (the default) or full: what is shown up front and what a draft proposes.

step'options' | 'scenarios' | 'dimensions' | 'sources' | 'view' | 'ask' required

The furthest step reached. It never goes back.

scenariosStated'none' | ''

none: no scenarios apply, and any named are taken off; empty: not said.

sourceIdsstring[]

The library items put to it, whole: one left out is taken off.

Response

The question being asked, and what the wizard holds.

Example response

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

Changes

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