---
title: "What a workspace sees: its own questions, then every public one"
method: GET
path: "/questions"
tags: ["questions"]
---

# What a workspace sees: its own questions, then every public one

`GET /questions`

## Request

- Base URL: `https://api.swingfactor.ai/v1`
- URL: `https://api.swingfactor.ai/v1/questions`
- Auth: HTTP bearer

Readable on every plan. With `workspace`, that workspace’s questions come first, whatever their visibility — so a workspace that moves down still sees what it asked — then public questions from everywhere else. Without it, the public ones alone. Each links to its own workspace, where it can be read too.

## Query parameters

- `workspace` string, uuid: A workspace whose own questions come first. Absent: public questions alone.

## Response `200`

The questions.

- VisibleQuestionList
  - `items` Question[], required
    - `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
  - `total` integer, required
  - `offset` integer, required
  - `limit` integer, required

## Other responses

- `401`: No token, or not a valid one: `unauthorized`.

---

[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)