---
title: "GET /api/admin/briefs/lane"
method: GET
path: "/api/admin/briefs/lane"
tags: ["Admin"]
---

# GET /api/admin/briefs/lane

`GET /api/admin/briefs/lane`

## Query parameters

- `userId` string, required
- `laneId` string, required

## Response `200`

OK

- object
  - `userId` string, required
  - `lane` object, required
    - `laneId` string, required
    - `laneName` string, required
    - `description` string, required
    - `kind` 'core' | 'adjacent' | 'wildcard', required
    - `source` 'profile' | 'onboarding' | 'admin' | 'lane_updater' | 'thought_attribution' | 'adjacent_scout' | 'wildcard_scout' | 'engagement' | 'backfill', required
    - `whyReaderCares` string, nullable, required
    - `promotedAt` string, nullable, required
    - `effectiveScore` number, nullable, required
    - `searchQueries` string[], required
    - `recentAnchors` string[], required
    - `laneSchemaYaml` string, nullable, required
    - `laneSchemaGeneratedAt` string, nullable, required
    - `lastSearchAt` string, nullable, required
    - `counts` object, required
      - `unserved` integer, required
      - `served` integer, required
      - `candidates` integer, required
      - `searches` integer, required
      - `failedCandidates` integer, required
    - `unservedBriefs` object[], required
      - `briefId` string, required
      - `laneId` string, nullable
      - `laneName` string, nullable
      - `yaml` string, required
      - `parsed` object, nullable, required
        - `reasoning` string, required
        - `fields` object, required
      - `parseError` string, nullable
      - `sourceUrl` string, nullable
      - `sourceStoryId` string, nullable
      - `sourceStoryTitle` string, nullable
      - `servedStoryId` string, nullable
      - `servedStoryTitle` string, nullable
      - `createdAt` string, required
      - `servedAt` string, nullable
    - `servedBriefs` object[], required
      - `briefId` string, required
      - `laneId` string, nullable
      - `laneName` string, nullable
      - `yaml` string, required
      - `parsed` object, nullable, required
        - `reasoning` string, required
        - `fields` object, required
      - `parseError` string, nullable
      - `sourceUrl` string, nullable
      - `sourceStoryId` string, nullable
      - `sourceStoryTitle` string, nullable
      - `servedStoryId` string, nullable
      - `servedStoryTitle` string, nullable
      - `createdAt` string, required
      - `servedAt` string, nullable
    - `recentCandidates` object[], required
      - `id` string, required
      - `yaml` string, required
      - `parsed` object, nullable, required
        - `reasoning` string, required
        - `fields` object, required
      - `parseError` string, nullable
      - `status` 'pending' | 'inserted' | 'matched_existing' | 'rejected_low_quality' | 'failed', required
      - `statusReason` string, nullable
      - `sourceType` 'article' | 'story', required
      - `sourceUrl` string, nullable
      - `sourceStoryId` string, nullable
      - `sourceStoryTitle` string, nullable
      - `articleContentId` string, nullable
      - `articleTitle` string, nullable
      - `resolvedBriefId` string, nullable
      - `duplicateOfBriefId` string, nullable
      - `createdAt` string, required
    - `searches` object[], required
      - `id` string, required
      - `query` string, required
      - `createdAt` string, required
      - `resultCount` integer, required
      - `articleCount` integer, required
      - `candidateCount` integer, required
      - `insertedCount` integer, required
      - `matchedExistingCount` integer, required
      - `failedCount` integer, required

---

[API](https://skmtc.dev/fromolive/apis/olive-api.md) · [All operations](https://skmtc.dev/fromolive/apis/olive-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fromolive/olive-api/revisions/01f6261481a3/schema)