questions

Start asking a question, a step at a time

The wizard’s first step, left: the question is written, still being asked, and the month’s allowance spent. Its workspace’s alone, and not drafted, until it is asked.

post/workspaces/{id}/asking

Request

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

Path parameters

idstring uuid required

The workspace's id (a UUID).

Headers

Idempotency-Keystring

Any unique string. The same key, method, path and body within 24 hours answers with the first response instead of creating again; the same key on a different request is 409 idempotency_key_reused.

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.