List the research portfolio

Read one bounded page of active Research threads and the next cursor.

GET/api/v1/research/portfolio

API keyAPI key with research:read

Required boundary headers

x-api-key or Authorization: Bearer

Overview

What this route does

Use the portfolio route to build a caller-owned thread list. Pass the returned cursor to the next request rather than choosing an unbounded page size.

Contract

Request parameters

Query parameters

Only fields in this contract are accepted.

cursorOptionalquery string

Forward cursor returned by the previous portfolio page, maximum 128 characters.

limitOptionalquery integer

Page size from 1 through the configured portfolio maximum.

Default: configured default

Examples

Request and response

Example request

curl "https://vidbyte-backend.onrender.com/api/v1/research/portfolio?limit=20" \
  -H "x-api-key: $VIDBYTE_API_KEY"

Example response

{
  "threads": [{
    "encrypted_id": "rth_public_token",
    "thread_id": "opaque_thread_reference",
    "title": "AI tutoring evidence",
    "run_count": 2,
    "source_count": 12,
    "artifact_count": 8,
    "latest_run_status": "completed",
    "created_at": "2026-08-10T10:00:00Z",
    "updated_at": "2026-08-10T12:00:00Z"
  }],
  "next_cursor": "opaque_cursor_reference"
}

Response

Response and errors

Returns bounded thread summaries and next_cursor.
Deleted threads and internal identifiers are excluded from the projection.