---
title: "Get Brief"
method: GET
path: "/briefs/{brief_id}"
tags: ["Briefs"]
---

# Get Brief

`GET /briefs/{brief_id}`

## Request

- Base URL: `https://zeronoise.ai/api/v1`
- URL: `https://zeronoise.ai/api/v1/briefs/{brief_id}`
- Auth: HTTP bearer

## Response `200`

Published Brief

- Brief
  - `id` string, required: Opaque identifier; clients must not parse its format.
  - `object` 'brief', required
  - `agent_id` string, required: Opaque identifier; clients must not parse its format.
  - `organization_id` string, required: Opaque identifier; clients must not parse its format.
  - `title` string, required
  - `description` string, required
  - `period` object, required: Window of source content this brief covers, start inclusive and end exclusive. Scheduled briefs close shortly before the Agent's scheduled time (currently one hour) so Sources can finish syncing; requested briefs cover the requested window. Date briefs by this period.
    - `start_at` string, date-time, required
    - `end_at` string, date-time, required
  - `published_at` string, date-time, required
  - `links` Links, required
  - `state` 'current' | 'superseded', required: superseded: a regenerated brief for the same period replaced this historical generation, which stays readable. Deleted briefs return 404.
  - `superseded_by` object: Present when state is superseded; the brief that replaced this one, which may itself be superseded.
    - `object` 'brief', required
    - `id` string, required: Opaque identifier; clients must not parse its format.
  - `content` string, required: Public Markdown with opaque [[citation:<id>]] references
  - `operation_id` string: Opaque identifier; clients must not parse its format.

## Other responses

- `default`: RFC 9457 problem response

---

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