---
title: "List Briefs"
method: GET
path: "/briefs"
tags: ["Briefs"]
---

# List Briefs

`GET /briefs`

## Request

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

Lists non-empty Briefs from the credential's organization, within its workspace or Agent binding. With following=true, lists Briefs from Agents the user follows instead; credentials without a binding include other organizations' Agents the user can see. Pages are newest first. Empty generation outcomes remain available through their Operations.

## Query parameters

- `cursor` string
- `limit` integer
- `agent_id` string: Opaque identifier; clients must not parse its format.
- `following` boolean
- `since` string, date-time

## Response `200`

Published Briefs

- BriefPage
  - `data` BriefSummary[], required
    - `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
  - `page` object, required
    - `next_cursor` string, nullable
    - `has_more` boolean, required

## 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)