> ## Documentation Index > Fetch the complete documentation index at: https://docs.trypost.it/llms.txt > Use this file to discover all available pages before exploring further. # List Pinterest boards > Lists the boards of a Pinterest account, read live from Pinterest. Use a board `id` as `meta.board_id` on a Pinterest destination. `truncated` is `true` when TryPost could not read every page of boards from Pinterest. This endpoint also counts against a limit of 60 requests per minute per user, shared with the other Pinterest, Discord and TikTok lookup endpoints and with the same user's channel lookups in the TryPost app. ## OpenAPI ````yaml /openapi.json get /social-accounts/{account}/boards openapi: 3.1.0 info: title: TryPost API version: 2.0.0 description: >- REST API for TryPost. Authenticate with a workspace API key as a Bearer token. servers: - url: https://app.trypost.it/api description: TryPost Cloud security: - bearerAuth: [] tags: - name: Posts description: Create, read, update, delete and preview posts. - name: Post notes description: Internal notes on a post, visible to workspace members. - name: Approvals description: Approve or reject posts waiting for approval. - name: Recurrence description: Make a post repeat on a schedule. - name: Media and uploads description: Upload files and attach media to posts. - name: Social accounts description: Connected social accounts and their network-specific options. - name: Channels description: A channel's posting schedule and queue. - name: Ideas description: Ideas on the Create board. - name: Idea stages description: The groups (columns) of the ideas board. - name: Analytics description: Workspace and channel insights. - name: Labels description: Labels to organize posts and ideas. - name: Signatures description: Reusable text to append to posts. - name: Workspace description: The workspace the API key belongs to. - name: API keys description: Personal API keys for this workspace. - name: Webhooks description: Outgoing webhooks and their delivery logs. - name: Repurposes description: Automations that republish videos posted outside TryPost. - name: Platform description: Platform capabilities and content types. paths: /social-accounts/{account}/boards: parameters: - $ref: '#/components/parameters/AccountId' get: tags: - Social accounts summary: List Pinterest boards description: >- Lists the boards of a Pinterest account, read live from Pinterest. Use a board `id` as `meta.board_id` on a Pinterest destination. `truncated` is `true` when TryPost could not read every page of boards from Pinterest. This endpoint also counts against a limit of 60 requests per minute per user, shared with the other Pinterest, Discord and TikTok lookup endpoints and with the same user's channel lookups in the TryPost app. operationId: listPinterestBoards responses: '200': description: The account's boards. content: application/json: schema: type: object properties: boards: type: array items: $ref: '#/components/schemas/PinterestBoard' truncated: type: boolean example: boards: - id: '1029854735246987654' name: Product updates cover_url: https://i.pinimg.com/400x300/ab/cd/ef/abcdef.jpg truncated: false '401': description: >- Missing or invalid API key, or the Pinterest connection expired (body: Pinterest's message, or `Access token has expired or been revoked`). Reconnect the account in the app. content: application/json: schema: $ref: '#/components/schemas/ErrorBody' examples: invalid_key: summary: Invalid API key value: message: Token not found. pinterest_expired: summary: Pinterest connection expired value: message: Access token has expired or been revoked '402': $ref: '#/components/responses/PaymentRequired' '403': description: >- Pinterest refused the request (missing permission), or the API key may not be used (see the shared 403). content: application/json: schema: $ref: '#/components/schemas/ErrorBody' '404': $ref: '#/components/responses/NotFound' '422': description: The account is not a Pinterest account. content: application/json: schema: $ref: '#/components/schemas/ErrorBody' example: message: Boards are only available for Pinterest accounts. '429': description: >- Our rate limit was exceeded (`rate_limit_exceeded` body, `Retry-After` set), or Pinterest reports a rate limit (`{message}` body, no `Retry-After`). headers: Retry-After: description: Seconds to wait before retrying. Only for our own limit. schema: type: integer content: application/json: schema: oneOf: - $ref: '#/components/schemas/RateLimitErrorBody' - $ref: '#/components/schemas/ErrorBody' '500': description: >- Pinterest could not be reached (timeout), or another token refresh of this account was running. content: application/json: schema: $ref: '#/components/schemas/ErrorBody' example: message: Server Error '502': description: Pinterest answered with an error. content: application/json: schema: $ref: '#/components/schemas/ErrorBody' components: parameters: AccountId: name: account in: path required: true description: >- Social account (channel) id. An account of another workspace returns `404`. schema: type: string format: uuid example: 9c8b7a65-4d3e-4f2a-8b1c-0d9e8f7a6b54 schemas: PinterestBoard: type: object properties: id: type: string description: >- Pinterest board id. Send it as `meta.board_id` on a Pinterest destination. name: type: string cover_url: type: - string - 'null' description: Cover image of the board, when Pinterest has one. ErrorBody: type: object properties: message: type: string RateLimitErrorBody: type: object properties: name: type: string const: rate_limit_exceeded message: type: string examples: - Rate limit exceeded. Please retry after 30 seconds. responses: PaymentRequired: description: >- TryPost Cloud only: the workspace's account has no active subscription or trial. Body: `{"message": "Active subscription required."}`. content: application/json: schema: $ref: '#/components/schemas/ErrorBody' example: message: Active subscription required. NotFound: description: The resource does not exist in this workspace. content: application/json: schema: $ref: '#/components/schemas/ErrorBody' securitySchemes: bearerAuth: type: http scheme: bearer description: Workspace API key from Settings → API Keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.