---
title: "List saved research jobs with bounded workspace summaries"
method: GET
path: "/workspace/knowledge/research"
tags: ["Knowledge"]
---

# List saved research jobs with bounded workspace summaries

`GET /workspace/knowledge/research`

## Request

- Base URL: `https://blitzreels.com/api/v1`
- URL: `https://blitzreels.com/api/v1/workspace/knowledge/research`
- Auth: API key in header `Authorization`

Returns newest jobs first, including jobs started by other workspace agents. status=active filters to queued/running work. Source bodies, private storage keys and internal checkpoints are excluded.

## Query parameters

- `limit` integer
- `offset` integer
- `status` 'all' | 'active'

## Response `200`

Successful response

- object
  - `jobs` object[], required
    - `id` string, uuid, required
    - `status` 'queued' | 'running' | 'partial' | 'complete' | 'failed' | 'cancelled', required
    - `request` object, required
      - `prompt` string, required
      - `productUrl` string, uri, nullable, required
      - `seriesId` string, uuid, nullable, required
      - `language` string, required
      - `maxSources` integer, required
      - `maxCredits` number, required
      - `social` object
        - `platform` 'tiktok' | 'instagram', required
        - `targetUrl` string, uri, nullable, required
        - `page` integer, required
        - `cursor` integer, nullable, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `diagnostic` object, nullable, required
      - `code` 'budget_exhausted' | 'source_unavailable' | 'source_blocked' | 'provider_rejected' | 'provider_outcome_unknown' | 'storage_unavailable' | 'worker_interrupted' | 'billing_unavailable' | 'invalid_response' | 'knowledge_conflict' | 'permission_revoked' | 'input_too_large' | 'unsupported_operation' | 'rate_limited', required
      - `message` string, required
      - `retryable` boolean, required
    - `document` object, nullable, required
      - `id` string, uuid, required
      - `revision` integer, required
  - `canEdit` boolean, required
  - `bounds` object, required
    - `limit` integer, required
    - `maxLimit` 20, required
    - `offset` integer, required
    - `total` integer, required
    - `returned` integer, required
    - `hasMore` boolean, required
    - `truncated` boolean, required

## Other responses

- `400`: Invalid input data
- `401`: Authorization not provided
- `403`: Insufficient access
- `404`: Not found
- `500`: Internal server error

---

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