---
title: "GET /message_pin.list"
method: GET
path: "/message_pin.list"
tags: ["message_pin"]
---

# GET /message_pin.list

`GET /message_pin.list`

查询某个聊天会话的置顶消息列表

## Query parameters

- `vchannel_id` string, required

## Response `200`

request success

- MessagePin[]
  - `id` string
  - `team_id` string
  - `uid` string
  - `vchannel_id` string
  - `message_id` string
  - `message_key` string — 消息唯一索引 key
  - `created_at` string, data-time — 创建时间
  - `updated_at` string, data-time — 更新时间
  - `message` string — 消息

## Other responses

- `default` — request fail

## Changes

- **2018-10-11** `ba66de15d4cf` — 1 info
  - endpoint added
- **2017-03-13** `ef71aa691171` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/bearyinnovative/apis/beary-openapi/changes/message_pin.list/get.md)

---

[API](https://skmtc.dev/bearyinnovative/apis/beary-openapi.md) · [All operations](https://skmtc.dev/bearyinnovative/apis/beary-openapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bearyinnovative/beary-openapi/revisions/6e42a0e2d730/schema)