---
title: "Pin Message"
method: POST
path: "/message/{message_id}/pin"
tags: ["message"]
---

# Pin Message

`POST /message/{message_id}/pin`

This endpoint pins or unpins a message based on the `message_id` or `queue_id`

## Headers

- `x-phone` string

## Request body

- object
  - `pin` boolean, required — Whether to pin (true) or unpin (false) the message
  - `time` 1 | 7 | 30 — - Duration in days for how long the message stays pinned - Accepted values: 1 (1 day), 7 (7 days), 30 (30 days) - Defaults to 30 days if not provided - Only applies when pin is true

## Response `204`

204

- object — _204 No Content_

---

[API](https://skmtc.net/periskope/apis/api-local.md) · [All operations](https://skmtc.net/periskope/apis/api-local/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/periskope/api-local/versions/f2738ced87d8/schema)