> ## Documentation Index > Fetch the complete documentation index at: https://docs.so-me.studio/llms.txt > Use this file to discover all available pages before exploring further. # List the Pinterest boards of an account > Pinterest refuses a pin without a board, so read this route before you create a Pinterest post, then send the chosen board ID as `metaData.boardId`. The list includes secret boards and boards the account collaborates on, up to 250, and matches the MCP tool list_pinterest_boards. ## OpenAPI ````yaml /openapi.json get /v1/accounts/{id}/pinterest/boards openapi: 3.0.0 info: title: Social media studio API description: >- The Social media studio API lets you programmatically manage your social media workflow — create and schedule posts, organize media, track analytics, manage your team, and more. ## Base URL ``` https://api.so-me.studio ``` ## Authentication All `/v1/*` endpoints require an API key passed via the `X-API-Key` header. ``` X-API-Key: sk_live_xxxxxxxxxxxxxxxxxxxxxxxx ``` ## Scopes A key has full access unless you give it scopes when you create it. A scoped key can call only the endpoints its scopes cover; other endpoints return `403 Forbidden`. A `GET` endpoint needs `:read`; `POST`, `PUT`, `PATCH` and `DELETE` need `:write`, which includes `read`. Resources: `accounts`, `posts` (also drafts and approvals), `media`, `analytics` (read only), `inbox`, `ai`, `biolinks`, `teams`, `settings`, `webhooks`, `support`, `templates` (read only), `whatsapp`. The API key and workspace endpoints under `/v1/settings`, and `PATCH /v1/settings/profile`, need a full-access key. Scoped keys cannot use the MCP server. ## Getting your API key 1. Log in to your workspace at [Social media studio](https://so-me.studio) 2. Go to **Settings** > **API** tab 3. Click **New API Key**, give it a name, and copy the key > The full key is shown only once. Store it securely. ## Rate limits 60 requests per minute per workspace. If you exceed this, you'll receive a `429 Too Many Requests` response. ## Plans API access is available on the **Standard**, **Advanced**, and **Lifetime** plans. version: '1.0' contact: {} servers: - url: https://api.so-me.studio description: Production security: [] tags: - name: Posts description: Create, manage, schedule, and publish social media posts - name: Accounts description: Manage connected social media accounts - name: Drafts description: Create and manage draft posts - name: Media description: Upload, organize, and manage media files and folders - name: Analytics description: Platform and post-level analytics across social accounts - name: Inbox description: Social inbox conversations, replies, and saved replies - name: AI description: AI-powered text and image generation - name: Approvals description: Post approval workflow for team collaboration - name: Teams description: Team member and invitation management - name: Biolinks description: Bio link pages with buttons, posts, and themes - name: Settings description: Profile, organization, API keys, billing, and usage - name: Authentication description: Register, login, password reset, and device authorization - name: Plans description: Available subscription plans, features, and addons - name: Public Biolink description: Public biolink page resolution and analytics tracking (no auth required) paths: /v1/accounts/{id}/pinterest/boards: get: tags: - Accounts summary: List the Pinterest boards of an account description: >- Pinterest refuses a pin without a board, so read this route before you create a Pinterest post, then send the chosen board ID as `metaData.boardId`. The list includes secret boards and boards the account collaborates on, up to 250, and matches the MCP tool list_pinterest_boards. operationId: V1AccountsController_pinterestBoards parameters: - name: id required: true in: path description: Social account UUID schema: type: string responses: '200': description: The boards of the account content: application/json: schema: $ref: '#/components/schemas/V1PinterestBoardsDto' '400': description: >- The account is not a Pinterest account, is not connected, or Pinterest refused access '404': description: Account not found security: - X-API-Key: [] components: schemas: V1PinterestBoardsDto: type: object properties: data: type: array items: $ref: '#/components/schemas/V1PinterestBoardDto' meta: $ref: '#/components/schemas/V1PinterestBoardsMetaDto' required: - data - meta V1PinterestBoardDto: type: object properties: id: type: string description: >- The board ID. Send it as `metaData.boardId` when you create a Pinterest post. example: '1234567890123456789' name: type: string description: The board name. example: Recipes description: type: string nullable: true description: The board description, or null when it has none. example: null privacy: type: string description: Who can see the board. enum: - PUBLIC - PROTECTED - SECRET example: PUBLIC required: - id - name - description V1PinterestBoardsMetaDto: type: object properties: total: type: number description: The number of boards in `data`. example: 1 hasMore: type: boolean description: >- True when the account has more boards than Pinterest returns at once (250). `data` then holds the first 250. example: false required: - total - hasMore securitySchemes: X-API-Key: type: apiKey in: header name: X-API-Key ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.