---
title: "List inbox threads"
method: GET
path: "/v1/workspaces/{workspaceId}/inbox/threads"
tags: ["Inbox"]
---

# List inbox threads

`GET /v1/workspaces/{workspaceId}/inbox/threads`

## Request

- Base URL: `https://api.maevesocial.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.maevesocial.com/v1/workspaces/{workspaceId}/inbox/threads`
- Auth: HTTP bearer

## Path parameters

- `workspaceId` string, uuid, required

## Query parameters

- `platform` 'instagram' | 'facebook' | 'threads' | 'google-business-profile' | 'youtube' | 'linkedin' | 'linkedin-page' | 'tiktok'
- `status` 'open' | 'all'
- `integrationId` string, uuid
- `messageType` 'comment' | 'dm' | 'review' | 'mention'
- `search` string
- `read` 'read' | 'unread' | 'all'
- `resolution` 'resolved' | 'unresolved' | 'all'
- `tagIds` string[]
- `tagMatch` 'any' | 'all'
- `page` integer
- `limit` integer

## Response `200`

Paginated inbox thread list

- object
  - `data` PublicInboxThreadDto[], required
    - `id` string, uuid, required
    - `platform` string, required
    - `messageType` 'comment' | 'dm' | 'review' | 'mention', required
    - `integrationId` string, uuid, required
    - `accountName` string, nullable, required
    - `accountAvatarUrl` string, nullable, required
    - `platformPermalink` string, nullable, required
    - `postPreviewCaption` string, nullable, required
    - `postPreviewMediaUrl` string, nullable, required
    - `participant` PublicInboxParticipantDto, required
      - `name` string, nullable, required
      - `handle` string, nullable, required
      - `avatarUrl` string, nullable, required
    - `status` 'open', required
    - `isRead` boolean, required
    - `isResolved` boolean, required
    - `resolvedAt` string, nullable, required
    - `resolvedBy` PublicInboxResolvedByDto, required
      - `id` string, uuid, required
      - `name` string, required
      - `initials` string, required
    - `resolvedReason` string, nullable, required
    - `resolvedNote` string, nullable, required
    - `assignedTo` PublicInboxResolvedByDto, required
      - `id` string, uuid, required
      - `name` string, required
      - `initials` string, required
    - `lastMessageAt` string, nullable, required
    - `messageCount` number, required
    - `lastMessagePreview` string, nullable, required
    - `replyWindowExpiresAt` string, nullable, required
    - `isReplyable` boolean, required
    - `capabilities` PublicInboxCapabilitiesDto, required
      - `canReply` boolean, required
      - `canHide` boolean, required
      - `canDelete` boolean, required
      - `canAttachMedia` boolean, required
    - `tags` PublicInboxTagDto[], required
      - `id` string, uuid, required
      - `name` string, required
      - `color` string, nullable, required
      - `sortOrder` number
      - `createdAt` string, nullable
      - `updatedAt` string, nullable
  - `meta` OffsetPaginationMetaDto, required
    - `limit` number, required
    - `offset` number, required
    - `total` number, required
    - `hasMore` boolean, required

---

[API](https://skmtc.dev/maevesocial/apis/maeve-social-api.md) · [All operations](https://skmtc.dev/maevesocial/apis/maeve-social-api/llms.txt) · [OpenAPI document](https://skmtc.dev/maevesocial/apis/maeve-social-api/revisions/1b00fd7e4b15?raw)