---
title: "List Pinterest boards"
method: GET
path: "/platforms/pinterest/boards"
tags: ["Connections"]
---

# List Pinterest boards

`GET /platforms/pinterest/boards`

## Request

- Base URL: `https://api.shortsync.app/v1`
- URL: `https://api.shortsync.app/v1/platforms/pinterest/boards`
- Auth: HTTP bearer

Lists the boards on the Pinterest account connected to the
workspace. Use a board's `id` as `platform_options.pinterest.board_id`.

## Response `200`

Boards.

- object
  - `data` object[]
    - `id` string
    - `name` string
    - `description` string, nullable
    - `privacy` string: e.g. `PUBLIC`, `PROTECTED`, `SECRET`.

## Other responses

- `400`: Pinterest is not connected for this workspace (`PINTEREST_NOT_CONNECTED`).
- `401`: Missing, malformed, or revoked token.
- `403`: Token is valid but cannot access this resource. Common cases: - `INSUFFICIENT_SCOPE` - token lacks the required scope. - `WORKSPACE_NOT_ALLOWED` - account token is allowlisted to other workspaces.
- `429`: Per-key sliding-window rate limit (60 req/min), per-org monthly request quota, or per-user upload cap was hit. `RATE_LIMIT_EXCEEDED` carries the window headers; `QUOTA_EXCEEDED` carries `details.quota` (which counter), `used`, `limit`, `resets_at`, and `upgrade_url`. `UPLOAD_QUOTA_EXCEEDED` (Free tier on `POST /posts` only) carries the same shape plus `details.remaining`.

---

[API](https://skmtc.dev/shortsync/apis/shortsync-api.md) · [All operations](https://skmtc.dev/shortsync/apis/shortsync-api/llms.txt) · [OpenAPI document](https://skmtc.dev/shortsync/apis/shortsync-api/revisions/71fdaef1e400?raw)