---
title: "POST /message_pin.create"
method: POST
path: "/message_pin.create"
tags: ["message_pin"]
---

# POST /message_pin.create

`POST /message_pin.create`

置顶消息

## Request body

- object
  - `vchannel_id` string, required — 消息所在的频道
  - `message_key` string, required — 想要置顶的消息 key

## 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.create/post.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/af2ef45fcabb/schema)