---
title: "Create Board Pin"
method: POST
path: "/v3.0/pinned-boards/"
tags: ["pinned-boards"]
---

# Create Board Pin

`POST /v3.0/pinned-boards/`

## Request

- Base URL: `https://api.formaloo.me`
- URL: `https://api.formaloo.me/v3.0/pinned-boards/`
- Auth: none declared. Required headers: `x-api-key`

# Pin a board

You can pin a board by simply sending its slug in the body. Current user should have read access to the board on the current workspace. There's no limit on the number of the pinned boards. If you pin a board that has already been pinned, you will get an error.

## Headers

- `x-api-key` string, required
- `x-workspace` string

## Request body

- BoardPinRequest
  - `board` string, required: slug of the board user wants to pin.

## Response `201`

- BoardPin
  - `board` string, required: slug of the board user wants to pin.

---

[API](https://skmtc.dev/formaloo/apis/formaloo-api-documentation.md) · [All operations](https://skmtc.dev/formaloo/apis/formaloo-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/formaloo/apis/formaloo-api-documentation/revisions/47b268aeb656?raw)