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

# List Stories

`GET /instagram/stories`

## Request

- Base URL: `https://api.reeldrop.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.reeldrop.io/instagram/stories`
- Auth: HTTP bearer

Currently-live stories (the ~24h active window) for the connected account.

Used to scope a story_reply automation to one specific live story: the id
returned here is the same media id that arrives on the reply webhook
(message.reply_to.story.id), so selecting one and storing it in the
automation's post_ids makes the engine fire only on replies to that story.

## Query parameters

- `workspace_id` string, nullable: Workspace this request applies to. Defaults to the caller's personal workspace. Must be one the caller belongs to.

## Response `200`

Successful Response

- MediaListResponse
  - `items` MediaItemOut[], required
    - `id` string, required
    - `caption` string
    - `media_type` string
    - `media_product_type` string
    - `thumbnail_url` string
    - `permalink` string
    - `timestamp` string

## Other responses

- `422`: Validation Error

---

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