---
title: "List stored replies and comments"
method: GET
path: "/engagement"
tags: ["Engagement"]
---

# List stored replies and comments

`GET /engagement`

## Request

- Base URL: `https://app.openpo.st/api/v1`
- URL: `https://app.openpo.st/api/v1/engagement`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `openpost_session`

## Query parameters

- `workspace_id` string, required
- `platform` string
- `account_id` string
- `publication_id` string
- `unread_only` boolean
- `archived` boolean
- `limit` integer
- `offset` integer
- `cursor` string: Opaque cursor for stable older-page pagination

## Response `200`

OK

- EngagementPage
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `items` EngagementItem[], nullable, required
    - `account_username` string
    - `archived_at` string, date-time
    - `attachments` EngagementAttachment[], nullable, required
      - `alt_text` string
      - `mime_type` string
      - `name` string
      - `thumbnail` string
      - `type` string, required
      - `url` string, required
    - `author_avatar_url` string, required
    - `author_handle` string, required
    - `author_name` string, required
    - `author_remote_id` string, required
    - `body` string, required
    - `can_delete` boolean, required
    - `can_hide` boolean, required
    - `can_like` boolean, required
    - `can_reply` boolean, required
    - `can_unlike` boolean, required
    - `conversation_remote_id` string, required
    - `created_at` string, date-time, required
    - `deleted_at` string, date-time
    - `edited_at` string, date-time
    - `hidden` boolean, required
    - `id` string, required
    - `is_ours` boolean, required
    - `last_seen_at` string, date-time, required
    - `liked` boolean, required
    - `parent_remote_id` string, required
    - `platform` string, required
    - `provider_post_url` string
    - `publication_excerpt` string
    - `publication_id` string
    - `publication_title` string
    - `read_at` string, date-time
    - `remote_created_at` string, date-time
    - `remote_id` string, required
    - `rendition_id` string, required
    - `social_account_id` string, required
    - `updated_at` string, date-time, required
    - `workspace_id` string, required
  - `next_cursor` string
  - `sync_states` EngagementSyncState[], nullable, required
    - `error_code` string, required
    - `error_message` string, required
    - `id` string, required
    - `last_success_at` string, date-time
    - `next_sync_at` string, date-time
    - `platform` string, required
    - `rendition_id` string, required
    - `social_account_id` string, required
    - `status` string, required
  - `total` integer, required

## Other responses

- `default`: Error

---

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