---
title: "List Media"
method: GET
path: "/instagram/media"
tags: ["instagram"]
---

# List Media

`GET /instagram/media`

## 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/media`
- Auth: HTTP bearer

Recent posts/reels for the connected account — used to target automations to a specific post.

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