---
title: "Upload Question Bank API"
method: POST
path: "/v1/qa/questions"
tags: ["Q&A APIs"]
---

# Upload Question Bank API

`POST /v1/qa/questions`

Question Bank API lets you upload your *question bank* to Miso. A *question bank* is a list of questions that
can be used for **Question Autocomplete** and **Similar Question Search**.

This API follows a *replace-all* model, i.e. a successful upload request will replace all the existing questions
in the question bank.

For example, the following request will replace the existing question bank with the given three questions:
```
POST /v1/qa/questions
{"data": [
    {"question": "What is python?"},
    {"question": "What is list comprehension?"},
    {"question": "How to sort a list in Python?"}
]}
```

## Request body

- PostQuestionRequest — Post questions request
  - `data` AppSchemasEngineApiRequestQuestion[], required
    - `question` string, required — The text of question.
    - `weight` number — The weight of question.

## Response `200`

Successful Response

- BaseResponse
  - `message` string
  - `data` BaseBody, required
    - `took` integer — Number of milliseconds Miso took to retrieve the results.
    - `miso_id` string, uuid — Miso-generated unique Id for each recommendation or search result. Maintaining this Id for subsequent page views is important to Miso's performance as we use `miso_id` to track and fine-tune the performance of personalization and search results. When a user clicks on a recommendation or search result, you should pass the associated `miso_id` to the next page view, and associate the `miso_id` with the interactions that take place on the page (e.g. `product_detail_page_view`, `add_to_cart`, `add_to_collection`, `like`, etc.). In this way, Miso will learn which recommendations work and which didn't. Example: ``` {"misoId": "123e4567-e89b-12d3-a456-426614174000"} ```

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/askmiso/apis/miso-api.md) · [All operations](https://skmtc.net/askmiso/apis/miso-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/askmiso/miso-api/versions/f2fa5ba6025f/schema)