---
title: "Return all messages for a particular user"
method: GET
path: "/v1/org/{orgId}/message/me"
tags: ["message"]
---

# Return all messages for a particular user

`GET /v1/org/{orgId}/message/me`

## Path parameters

- `orgId` string, required

## Query parameters

- `type` string
- `unreadOnly` boolean
- `from` string
- `limit` integer

## Response `200`

successful operation

- ResultsMessage
  - `data` Message[], required
    - `id` string, required — globally unique id
    - `orgId` string, required — parent organization id
    - `type` 'CHAT' | 'EMAIL' | 'WEB', required — type of message
    - `notificationType` 'SUCCESS' | 'WARN' | 'ERROR' | 'COMMENT' | 'TASK_COMPLETED' | 'TASK_ASSIGNED' | 'REMINDER' | 'ANNOUNCEMENT' | 'PROCESS_ERROR' | 'PROCESS_DONE' | 'SHARE', required — type of notification (SUCCESS, ERR, ANNOUNCEMENT etc.)
    - `userId` string, required — user who receives the message
    - `content` object — message content
    - `title` string — message title
    - `messageUrl` string — link to message content (if applicable)
    - `key` string — key of message if applicable (e.g. product-tour, import-complete-{id})
    - `readAt` string — read timestamp
    - `seenAt` string — seen timestamp
    - `createId` string — created by user id
    - `createBehalfId` string — created on behalf of user id
    - `createAttribution` Attribution
      - `principalUserId` string
      - `agentUserIds` string[]
      - `eventId` string
      - `aiChatId` string
      - `aiToolUseId` string
      - `channel` 'WEB' | 'MOBILE' | 'SLACK' | 'TEAMS' | 'MCP'
    - `createAt` string, required — created timestamp
  - `next` string
  - `access` ResultsAccess[]
    - `ids` string[]
    - `allowed` AccessAction[], required
      - `action` string, required
      - `fields` string[]
      - `types` string[]

## Other responses

- `401` — unauthorized

---

[API](https://skmtc.net/charthop/apis/charthop-api.md) · [All operations](https://skmtc.net/charthop/apis/charthop-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/charthop/charthop-api/revisions/26da34ae934f/schema)