---
title: "List stories"
method: GET
path: "/stories"
tags: ["Stories"]
---

# List stories

`GET /stories`

## Request

- Base URL: `https://api.modem.dev/v1`
- URL: `https://api.modem.dev/v1/stories`
- Auth: HTTP bearer

List generated stories for an organization.

## Query parameters

- `bucket` 'archived' | 'everything' | 'for-you' | 'unread'
- `limit` integer

## Response `200`

OK

- object
  - `archivedCount` integer, required
  - `everythingCount` integer, required
  - `forYouCount` integer, required
  - `stories` object[], required
    - `archive` object, nullable, required
      - `actor` union, required
        - object
          - `name` 'Modem Agent', required
          - `type` 'agent', required
        - object
          - `image` string, nullable, required
          - `name` string, required
          - `type` 'member', required
          - `userId` union, required
            - string
            - string
      - `archivedAt` string, date-time
      - `reason` string, nullable, required
    - `createdAt` string, date-time
    - `draft` object, required
      - `detail` object, required
        - `main` object, required
          - `elements` object, required
          - `root` string, required
        - `sidebar` object, required
          - `elements` object, required
          - `root` string, required
        - `title` unknown
      - `list` object, required
        - `elements` object, required
        - `root` string, required
      - `slug` string, required
      - `sourceRefs` object[]
        - `id` string, required
        - `label` string
        - `type` 'author' | 'company' | 'email' | 'intercom' | 'issue' | 'message' | 'person' | 'slack' | 'topic', required
      - `summary` unknown
      - `title` unknown
      - `version` unknown, required
    - `isRead` boolean, required
    - `viewerRelevance` object, nullable, required
      - `linkedAuthorIds` union[], required
        - union
          - string, uuid
          - string, uuid
      - `memberId` union, required
        - string
        - string
      - `relevanceKind` 'action' | 'awareness' | 'ownership', required
      - `relevanceLabel` string, nullable, required
      - `relevanceRationale` string, required
      - `user` object, required
        - `id` union, required
          - string
          - string
        - `image` string, nullable, required
        - `name` string, required: Human-readable name of the user.
  - `unreadCount` integer, required
  - `visitedThrough` string, date-time, required

## Other responses

- `400`: Invalid request (validation failed).
- `401`: Missing or invalid API key.
- `403`: The API key does not have access to this resource.
- `404`: The requested resource was not found.
- `429`: Rate limit exceeded.
- `500`: Internal server error.

---

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