---
title: "Answer a research request's questions"
method: POST
path: "/v1/research-requests/{id}/question-answers"
---

# Answer a research request's questions

`POST /v1/research-requests/{id}/question-answers`

## Request

- Base URL: `https://api.ploti.ai`
- URL: `https://api.ploti.ai/v1/research-requests/{id}/question-answers`
- Auth: HTTP bearer

Send the user's answers to the questions a research request's data check asked (get_research_request shows them while its status is needs_answer); the check then goes on. Ask the user each question in your own chat and send what they said: never guess or answer for them. Answer each question by its id: an option by its id or its label, or the user's own words as text; a question left out is skipped, when the questions allow it. The check searches the web as it goes on, and once it reports, Ploti files the missing data itself, as after create_research_request. Returns the request with its new status and link; get_research_request has the report once the check finishes.

## Path parameters

- `id` string, required

## Request body

- object
  - `answers` object, required: Each question's answer by question id: an option id or label, the user's own text, a list for a question that takes several, or null to skip it.

## Response `200`

Done

- object
  - `request` object, required
    - `id` string, required
    - `title` string, required
    - `status` 'checking' | 'needs_answer' | 'report_ready' | 'data_requested' | 'researching' | 'complete', required
    - `statusText` string, required
    - `links` object, required
      - `view` string, required

## Other responses

- `401`: The credential is missing or not valid.
- `413`: payload_too_large: the body is over 256 KB (2 MB for /v1/tools).
- `415`: unsupported_media_type: a body was sent without Content-Type: application/json.
- `429`: rate_limited: this credential is over its rate. Retry after the Retry-After header's seconds.
- `500`: internal: Ploti failed. Retry; if it keeps happening, contact support.
- `default`: Refused: nothing was done. The code says why and the links say where the person acts on it.

---

[API](https://skmtc.dev/ploti/apis/ploti-api.md) · [All operations](https://skmtc.dev/ploti/apis/ploti-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ploti/apis/ploti-api/revisions/8c2c91c72d52?raw)