---
title: "List Run Questions"
method: GET
path: "/api/v1/runs/{id}/questions"
tags: ["Human-in-the-Loop"]
---

# List Run Questions

`GET /api/v1/runs/{id}/questions`

Returns pending human-in-the-loop questions for a run. Questions are generated when the workflow needs user input to proceed.

## Path parameters

- `id` string, required

## Query parameters

- `page[limit]` integer
- `page[offset]` integer

## Response `200`

Array of pending questions

- PaginatedApiQuestionList — Paginated list of pending questions.
  - `data` ApiQuestion[], required
    - `id` string, required — Unique question identifier.
    - `text` string, required — The question text displayed to the user.
    - `stage` string, required — Workflow stage identifier that produced the question.
    - `question_type` 'yes_no' | 'multiple_choice' | 'multi_select' | 'freeform' | 'confirmation', required — The interaction type of a human-in-the-loop question.
    - `options` InterviewOption[], required — Available options for selection-based questions. Empty for freeform questions.
      - `key` string, required — Machine-readable option key used when submitting an answer.
      - `label` string, required — Human-readable label displayed to the user.
      - `description` string, nullable — Optional untrusted model-authored option description for display.
      - `preview` string, nullable — Optional untrusted model-authored option preview captured for clients.
    - `allow_freeform` boolean, required — Whether the user may provide freeform text in addition to selecting options.
    - `timeout_seconds` number, double, nullable — Timeout for the question when configured by the workflow.
    - `context_display` string, nullable — Optional contextual text shown alongside the question.
    - `review_target` ReviewTarget — A validated external resource presented as the primary subject of a human review question.
      - `label` string, required — Human-readable link label.
      - `url` string, uri, required — Absolute HTTP or HTTPS URL opened by the reviewer.
      - `kind` 'document', required — The type of resource presented for human review.
  - `meta` PaginationMeta, required — Pagination metadata included in every paginated response.
    - `has_more` boolean, required — Whether additional pages of results are available.
    - `total` integer — Total number of items matching the current filters. Optional — only populated by endpoints that compute the full count cheaply (e.g. in-memory filtering). When omitted, clients should rely on `has_more` and cursor through pages.

## Other responses

- `404` — Run not found

---

[API](https://skmtc.net/fabro-sh/apis/fabro-run-api.md) · [All operations](https://skmtc.net/fabro-sh/apis/fabro-run-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fabro-sh/fabro-run-api/revisions/64a24779d395/schema)