---
title: "Run a query and get generated text with retrieved passages"
method: POST
path: "/v1/run"
---

# Run a query and get generated text with retrieved passages

`POST /v1/run`

## Request body

- object
  - `query` string, required — The query string
  - `result_column` string — The result column name

## Response `200`

Successful response

- union
  - object
    - `type` 'generated_text' | 'retrieved_passage', required — When the type is "generated_text", only "generated_text" is returned. The other fields are None. When the type is "retrieved_passage", only "retrieved_passage" and "passage_index" are returned. The other fields are None.
    - `generated_text` string, nullable, required — The generated text, only present when "type" is "generated_text".
    - `retrieved_passage` object, nullable
      - `content` string
      - `doc_id` string
      - `filepath` string, nullable
      - `file_page` integer, nullable
      - `start_idx` integer, nullable
      - `end_idx` integer, nullable
    - `passage_index` integer, nullable — The index of the retrieved passage, only present when "type" is "retrieved_passage".
  - object
    - `type` 'generated_text' | 'retrieved_passage', required — When the type is "generated_text", only "generated_text" is returned. The other fields are None. When the type is "retrieved_passage", only "retrieved_passage" and "passage_index" are returned. The other fields are None.
    - `generated_text` string, nullable — The generated text, only present when "type" is "generated_text".
    - `retrieved_passage` object, nullable, required
      - `content` string
      - `doc_id` string
      - `filepath` string, nullable
      - `file_page` integer, nullable
      - `start_idx` integer, nullable
      - `end_idx` integer, nullable
    - `passage_index` integer, nullable, required — The index of the retrieved passage, only present when "type" is "retrieved_passage".

---

[API](https://skmtc.dev/marker-inc-korea/apis/example-api.md) · [All operations](https://skmtc.dev/marker-inc-korea/apis/example-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/marker-inc-korea/example-api/revisions/19765fce26c8/schema)