Read one research thread

Read one owned active thread and its public rollup counters.

GET/api/v1/research/threads/{encrypted_id}

API keyAPI key with research:read

Required boundary headers

x-api-key or Authorization: Bearer

Overview

What this route does

Use this route when a caller already knows the encrypted thread token and needs the current thread-level status, counts, or favorite projection.

Examples

Request and response

Example request

curl "https://vidbyte-backend.onrender.com/api/v1/research/threads/rth_public_token" \
  -H "x-api-key: $VIDBYTE_API_KEY"

Example response

{
  "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",
  "latest_run_phase": "settled",
  "favorite": false,
  "created_at": "2026-08-10T10:00:00Z",
  "updated_at": "2026-08-10T12:00:00Z"
}

Response

Response and errors

Returns the typed thread detail projection and rollup counters.
Raw Mongo identifiers, owner IDs, and source bodies are never returned.