---
title: "Ask SwingFactor to find something out"
method: POST
path: "/workspaces/{id}/questions/{questionId}/requests"
tags: ["fixes"]
---

# Ask SwingFactor to find something out

`POST /workspaces/{id}/questions/{questionId}/requests`

## Request

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

An editor’s, in their words, about the question or one option. It stays open until a draft or a person answers it, or whoever asked withdraws it. Start a draft focused on requests to have SwingFactor work on it now.

## Path parameters

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

## Headers

- `Idempotency-Key` string

## Request body

- FindOutRequestBody
  - `text` string, required: What to find out, in the person’s words.
  - `optionId` string, uuid, nullable: The option it is about; none, the question.

## Response `201`

The request, open.

- FindOutRequest
  - `id` string, uuid, required
  - `workspaceId` string, uuid, required
  - `questionId` string, uuid, required
  - `kind` 'find-out', required
  - `text` string, required
  - `optionId` string, uuid, nullable, required
  - `status` 'open' | 'answered' | 'withdrawn', required
  - `createdBy` string, uuid, nullable, required
  - `createdByName` string, nullable, required
  - `createdAt` string, required
  - `answer` string, nullable, required
  - `answeredAt` string, nullable, required
  - `answeredByName` string, nullable, required
  - `answeredDraftId` string, uuid, nullable, required
  - `withdrawnAt` string, nullable, required
  - `links` FindOutRequestLinks, required: Relative /v1 URLs to follow.
    - `self` string, required
    - `answer` string, required
    - `withdrawal` string, required
    - `question` string, required

## Other responses

- `401`: No token, or not a valid one: `unauthorized`.
- `403`: Only the question’s editors ask, as themselves.
- `404`: No such question or option.

---

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