---
title: "POST /api/stories/advance"
method: POST
path: "/api/stories/advance"
tags: ["Stories"]
---

# POST /api/stories/advance

`POST /api/stories/advance`

## Request body

- object
  - `storyId` string, required
  - `followUpLabel` string, required

## Response `200`

OK

- StoryRequestNewResponse
  - `storyList` StoryListResponse, required
    - `todayDate` string, required
    - `storiesReadToday` integer, required
    - `storiesReadThisWeek` integer, required
    - `previouslySeenCount` integer
    - `isCurating` boolean
    - `needsFeedRefinement` boolean
    - `stories` StorySummary[], required
      - `storyId` string, required
      - `title` string, required
      - `subtitle` string, required
      - `pickerMessages` string[], nullable
      - `status` 'ready' | 'pending' | 'failed', required
      - `reaction` 'not_for_me' | 'love', nullable
      - `reactedAt` string, nullable
      - `stickerImageUrl` string
      - `segmentCount` integer, required
      - `lastViewedSegmentIndex` integer, required
      - `lastTouchedAt` string, required
      - `createdAt` string, required
      - `startedAt` string
      - `completedAt` string
      - `hiddenAt` string
      - `hiddenReason` 'expired' | 'admin' | 'completed' | 'disliked' | 'errored'
      - `archivedAt` string
      - `expiredAt` string
      - `forDate` string
      - `sharedByName` string, nullable
      - `commissioned` boolean
      - `reviewedAt` string, nullable
      - `reviewedAs` 'saved' | 'auto_saved' | 'already_known' | 'didnt_understand' | 'not_interested' | 'dismissed', nullable
  - `pendingStoryIds` string[], 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)