---
title: "List Inbox"
method: GET
path: "/v2/communication/inbox"
tags: ["v2 - Communication"]
---

# List Inbox

`GET /v2/communication/inbox`

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

Messages relevant to the authenticated user: those that mention them, or
those in a workspace they can reach. Server-side scope (no client N+1).
Sorted newest-first, soft-deleted excluded, offset-paginated.

OPEN ONLY, BY DEFAULT. The inbox is the list of things still to deal
with; a message marked handled (PATCH /{id}/resolve) leaves it. Without
this the list was append-only and a 193-day-old test comment sat at the
top of the home page with no way off.

## Query parameters

- `limit` integer
- `offset` integer
- `include_resolved` boolean: Also return messages already marked handled. Default: open only.

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