Gallery Platform API
Reference

List inbox threads

Lists the signed-in member's own Inbox threads with cursor pagination, most-recent activity first. Filter by `state`, `channel`, `assigned_to`, and `unread`. The Inbox is member-private, so this is a first-party (session) surface.

GET
/gallery/inbox/threads

Lists the signed-in member's own Inbox threads with cursor pagination, most-recent activity first. Filter by state, channel, assigned_to, and unread. The Inbox is member-private, so this is a first-party (session) surface.

Authorization

bearerAuth inbox:read
AuthorizationBearer <token>

A gallery API key, sent as Authorization: Bearer gpk_… (or the x-api-key header).

In: header

Scope: inbox:read

Query Parameters

limit?integer
Range1 <= value <= 100
Default20
cursor?string
state?string

Value in

  • "open"
  • "snoozed"
  • "done"
channel?string

Value in

  • "email"
  • "whatsapp"
  • "sms"
assigned_to?string
contact_id?string
unread?boolean
q?string
Length1 <= length <= 200
sort?string

Sort by one of: last_message, created (default last_message).

Value in

  • "last_message"
  • "created"
dir?string

Sort direction (default desc).

Value in

  • "asc"
  • "desc"

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

{  "data": [    {      "id": "string",      "channel": "email",      "contact_id": "string",      "contact_name": "string",      "connection_id": "d3547de1-d1f2-4344-b4c2-17169b7526f9",      "provider_thread_id": "string",      "subject": "string",      "last_from": "string",      "last_snippet": "string",      "last_message_at": "string",      "unread_count": -9007199254740991,      "state": "open",      "assigned_to": "string",      "snooze_until": "string",      "created_at": "string",      "updated_at": "string"    }  ],  "next_cursor": "string"}