---
title: "What research tried: each search, each page it tried to read, and whether it could"
method: GET
path: "/workspaces/{id}/questions/{questionId}/research-trail"
tags: ["drafting"]
---

# What research tried: each search, each page it tried to read, and whether it could

`GET /workspaces/{id}/questions/{questionId}/research-trail`

## Request

- Base URL: `https://api.swingfactor.ai/v1`
- URL: `https://api.swingfactor.ai/v1/workspaces/{id}/questions/{questionId}/research-trail`
- Auth: HTTP bearer

Research provenance — how the evidence was looked for — never evidence about the question. A draft’s, or by default the latest draft’s that has one. The workspace’s members only.

## Path parameters

- `id` string, uuid, required
- `questionId` string, uuid, required

## Query parameters

- `draft` string, uuid

## Response `200`

The trail, stage by stage, in order.

- ResearchTrail
  - `items` ResearchTrailEntry[], required
    - `draftId` string, uuid, required
    - `stage` string, required
    - `position` integer, required
    - `kind` 'search' | 'fetch', required
    - `target` string, required: What was searched for, or the address tried.
    - `ok` boolean, nullable, required: Whether the page could be read; null where the result was not returned.
    - `error` string, nullable, required
    - `createdAt` string, required
  - `total` integer, required
  - `offset` integer, required
  - `limit` integer, required

## Other responses

- `401`: No token, or not a valid one: `unauthorized`.

---

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