---
title: "List Legacy Media Comments"
method: GET
path: "/v2/communication/legacy-media-comments"
tags: ["v2 - Communication"]
---

# List Legacy Media Comments

`GET /v2/communication/legacy-media-comments`

## Request

- Base URL: `https://api.jubjubapp.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.jubjubapp.com/v2/communication/legacy-media-comments`
- Auth: HTTP bearer

Read legacy Firestore comments from /media/{mediaId}/comments and
return them in the v2 MessageListResponse shape.

Returned messages have ``origin='legacy'`` and ``event_version=0``
so the dashboard can render them identically to v2 messages without
needing to know the source.

## Query parameters

- `media_id` string, required: Media document ID

## Headers

- `Authorization` string
- `X-JubJub-Service-Key` string
- `X-JubJub-Agent-Key` string
- `X-JubJub-Platform-Key` string
- `Origin` string
- `Referer` string
- `X-JubJub-Trial-Token` string

## Response `200`

Successful Response

- MessageListResponse: Cursor-paginated list of messages.
  - `messages` MessageResponse[], required
    - `message_id` string, required
    - `scope_type` string, required
    - `scope_id` string, required
    - `author_profile_id` string, nullable
    - `author` PersonView: Another person as anyone may see them (founder's rule, 2026-09-25). `member_ref` is opaque and scoped to the message's context: the workspace for workspace, content and media scopes, the team for a team scope. Post it back in `mentions` to mention this person. Never a profile ID or email; `profile_id` is filled only for a JubJub platform admin.
      - `member_ref` string, nullable
      - `display_name` string, required
      - `avatar_url` string, nullable
      - `handle` string, nullable
      - `is_you` boolean
      - `role` string, nullable
      - `via_team` string, nullable
      - `profile_id` string, nullable
    - `author_type` string, required
    - `author_service_id` string, nullable
    - `body` string, required
    - `mentions` string[]: member_refs of the people mentioned
    - `mention_profiles` PersonView[]
      - `member_ref` string, nullable
      - `display_name` string, required
      - `avatar_url` string, nullable
      - `handle` string, nullable
      - `is_you` boolean
      - `role` string, nullable
      - `via_team` string, nullable
      - `profile_id` string, nullable
    - `workspace_id` string, nullable
    - `timecode_seconds` integer, nullable
    - `version` integer, nullable
    - `parent_message_id` string, nullable
    - `thread_root_id` string, nullable
    - `message_type` string, required
    - `decision_type` string, nullable
    - `decision_status` string, nullable
    - `resolution` string, nullable
    - `origin` string, nullable
    - `event_version` integer
    - `metadata` object, nullable
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, nullable
    - `edited_at` string, date-time, nullable
    - `deleted_at` string, date-time, nullable
    - `resolved_at` string, date-time, nullable
    - `resolved_by` string, nullable
    - `resolved_by_profile` PersonView: Another person as anyone may see them (founder's rule, 2026-09-25). `member_ref` is opaque and scoped to the message's context: the workspace for workspace, content and media scopes, the team for a team scope. Post it back in `mentions` to mention this person. Never a profile ID or email; `profile_id` is filled only for a JubJub platform admin.
      - `member_ref` string, nullable
      - `display_name` string, required
      - `avatar_url` string, nullable
      - `handle` string, nullable
      - `is_you` boolean
      - `role` string, nullable
      - `via_team` string, nullable
      - `profile_id` string, nullable
  - `next_cursor` string, nullable: Opaque cursor for the next page; null means no more results
  - `has_more` boolean

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/jubjubapp/apis/jubjub-api.md) - [All operations](https://skmtc.dev/jubjubapp/apis/jubjub-api/llms.txt) - [OpenAPI document](https://skmtc.dev/jubjubapp/apis/jubjub-api/revisions/353157b296f2?raw)