List Run Questions

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

get/api/v1/runs/{id}/questions

Path parameters

idstring required

Unique run identifier (ULID).

Query parameters

page[limit]integer

Maximum number of items to return per page.

page[offset]integer

Number of items to skip before returning results.

Response

Array of pending questions

Example response

{
  "data": [
    {
      "id": "q-001",
      "text": "Should we proceed with the proposed changes?",
      "stage": "gate",
      "allow_freeform": true,
      "timeout_seconds": 30,
      "context_display": "Latest draft",
      "review_target": {
        "label": "Quarry review exercise",
        "url": "https://quarry.lithos.computer/tmp/0123456789abcdef0123456789abcdef"
      }
    }
  ]
}

Changes

Changed in 9 of the 135 revisions of this API.37

Jul 28, 2026ef906071a8e41See the full diff
- ○
  added the optional property data/items/review_target to the response with the 200 status
  response-optional-property-added
Jul 28, 20267fe7b67557991See the full diff
- ●
  removed the optional property data/items/review_target from the response with the 200 status
  response-optional-property-removed
This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jul 28, 20264f9aedeb72111See the full diff
- ○
  added the optional property data/items/review_target to the response with the 200 status
  response-optional-property-added
Jul 28, 2026d043ecc9a6521See the full diff
- ●
  removed the optional property data/items/review_target from the response with the 200 status
  response-optional-property-removed
This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jul 28, 2026cfe29a7884051See the full diff
- ○
  added the optional property data/items/review_target to the response with the 200 status
  response-optional-property-added
Jul 28, 2026fa4de608a93c1See the full diff
- ●
  removed the optional property data/items/review_target from the response with the 200 status
  response-optional-property-removed
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jul 28, 202613a1dbd0ac1f1See the full diff
- ○
  added the optional property data/items/review_target to the response with the 200 status
  response-optional-property-added
May 23, 20266a7f0f8f0dab2See the full diff
- ○
  added the optional property data/items/options/items/description to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/items/options/items/preview to the response with the 200 status
  response-optional-property-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
May 23, 2026f86b728d9d171See the full diff
- ○
  added the optional property meta/total to the response with the 200 status
  response-optional-property-added
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history