> ## 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.

# Listar os quadros do Pinterest de todas as contas do Pinterest

> Os quadros de todas as contas do Pinterest conectadas do espaço de trabalho, cada um com a conta a que pertence. Para um seletor que não consegue informar uma conta, como um campo do Make; nos outros casos, use GET /v1/accounts/{id}/pinterest/boards. Publique em um quadro a partir da própria conta dele. Uma conta cujos quadros não podem ser lidos aparece em `meta.errors`, e os quadros das outras contas são retornados mesmo assim.



## OpenAPI

````yaml /pt-BR/openapi.json get /v1/accounts/pinterest/boards
openapi: 3.0.0
info:
  title: Social media studio API
  description: >-
    A API do Social media studio permite gerenciar seu fluxo de trabalho de
    redes sociais via código: criar e agendar publicações, organizar mídia,
    acompanhar análises, gerenciar sua equipe e mais.


    ## URL base


    ```

    https://api.so-me.studio

    ```


    ## Autenticação


    Todos os endpoints `/v1/*` exigem uma chave de API enviada no cabeçalho
    `X-API-Key`.


    ```

    X-API-Key: sk_live_xxxxxxxxxxxxxxxxxxxxxxxx

    ```


    ## Scopes


    Uma chave tem acesso total, a menos que você defina scopes ao criá-la. Uma
    chave com scopes só pode chamar os endpoints cobertos por eles; os demais
    endpoints retornam `403 Forbidden`. Um endpoint `GET` exige
    `<resource>:read`; `POST`, `PUT`, `PATCH` e `DELETE` exigem
    `<resource>:write`, que inclui `read`. Recursos: `accounts`, `posts` (também
    rascunhos e aprovações), `media`, `analytics` (somente leitura), `inbox`,
    `ai`, `biolinks`, `teams`, `settings`, `webhooks`, `support`, `templates`
    (somente leitura), `whatsapp`. Os endpoints de chaves de API e de espaço de
    trabalho em `/v1/settings`, e `PATCH /v1/settings/profile`, exigem uma chave
    de acesso total. Chaves com scopes não podem usar o servidor MCP.


    ## Obter sua chave de API


    1. Entre no seu espaço de trabalho no [Social media
    studio](https://so-me.studio/pt-br)

    2. Vá em **Configurações** > aba **API**

    3. Clique em **Nova chave de API**, dê um nome a ela e copie a chave


    > A chave completa é exibida apenas uma vez. Guarde-a com segurança.


    ## Limites de taxa


    Por espaço de trabalho, conforme o plano: 30 requisições por minuto no Lite,
    60 no Creator e no Standard, 300 no Advanced e no Lifetime. Se você exceder
    o limite, receberá uma resposta `429 Too Many Requests`.


    ## Planos


    O acesso à API está incluído em todos os planos pagos: **Lite**,
    **Creator**, **Standard**, **Advanced** e **Lifetime**. A cota mensal de
    chamadas depende do plano.
  version: '1.0'
  contact: {}
servers:
  - url: https://api.so-me.studio
    description: Produção
security: []
tags:
  - name: Posts
    description: Criar, gerenciar, agendar e publicar publicações de redes sociais
  - name: Accounts
    description: Gerenciar as contas de redes sociais conectadas
  - name: Drafts
    description: Criar e gerenciar rascunhos
  - name: Media
    description: Enviar, organizar e gerenciar arquivos e pastas de mídia
  - name: Analytics
    description: Análises no nível da plataforma e da publicação em todas as contas sociais
  - name: Inbox
    description: Conversas, respostas e respostas salvas da caixa de entrada social
  - name: AI
    description: Geração de texto e imagem com IA
  - name: Approvals
    description: Fluxo de aprovação de publicações para colaboração da equipe
  - name: Teams
    description: Gerenciamento de membros da equipe e convites
  - name: Biolinks
    description: Páginas de link na bio com botões, publicações e temas
  - name: Settings
    description: Perfil, organização, chaves de API, faturamento e uso
  - name: Authentication
    description: Cadastro, login, redefinição de senha e autorização de dispositivo
  - name: Plans
    description: Planos de assinatura, recursos e complementos disponíveis
  - name: Public Biolink
    description: >-
      Resolução de páginas de biolink públicas e rastreamento de análises (sem
      autenticação)
paths:
  /v1/accounts/pinterest/boards:
    get:
      tags:
        - Accounts
      summary: Listar os quadros do Pinterest de todas as contas do Pinterest
      description: >-
        Os quadros de todas as contas do Pinterest conectadas do espaço de
        trabalho, cada um com a conta a que pertence. Para um seletor que não
        consegue informar uma conta, como um campo do Make; nos outros casos,
        use GET /v1/accounts/{id}/pinterest/boards. Publique em um quadro a
        partir da própria conta dele. Uma conta cujos quadros não podem ser
        lidos aparece em `meta.errors`, e os quadros das outras contas são
        retornados mesmo assim.
      operationId: V1AccountsController_workspacePinterestBoards
      parameters: []
      responses:
        '200':
          description: Os quadros de todas as contas do Pinterest
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V1WorkspacePinterestBoardsDto'
      security:
        - X-API-Key: []
components:
  schemas:
    V1WorkspacePinterestBoardsDto:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/V1WorkspacePinterestBoardDto'
        meta:
          $ref: '#/components/schemas/V1WorkspacePinterestBoardsMetaDto'
      required:
        - data
        - meta
    V1WorkspacePinterestBoardDto:
      type: object
      properties:
        id:
          type: string
          description: >-
            O ID do quadro. Envie-o como `metaData.boardId` ao criar uma
            publicação no Pinterest.
          example: '1234567890123456789'
        name:
          type: string
          description: O nome do quadro.
          example: Recipes
        description:
          type: string
          nullable: true
          description: A descrição do quadro, ou null quando ele não tem uma.
          example: null
        privacy:
          type: string
          description: Quem pode ver o quadro.
          enum:
            - PUBLIC
            - PROTECTED
            - SECRET
          example: PUBLIC
        accountId:
          type: string
          description: >-
            O UUID da conta do Pinterest dona do quadro. Publique no quadro a
            partir desta conta.
          example: 11111111-1111-4111-8111-111111111111
        accountName:
          type: string
          description: O nome dessa conta do Pinterest.
          example: mybrand
      required:
        - id
        - name
        - description
        - accountId
        - accountName
    V1WorkspacePinterestBoardsMetaDto:
      type: object
      properties:
        total:
          type: number
          description: O número de quadros em `data`.
          example: 3
        accounts:
          type: number
          description: O número de contas do Pinterest conectadas.
          example: 1
        hasMore:
          type: boolean
          description: >-
            true quando uma conta tem mais quadros do que o Pinterest retorna de
            uma vez (250). Nesse caso, `data` traz os primeiros 250 dela.
          example: false
        errors:
          description: >-
            As contas cujos quadros não puderam ser lidos. Os quadros das outras
            contas continuam em `data`.
          type: array
          items:
            $ref: '#/components/schemas/V1PinterestBoardsErrorDto'
      required:
        - total
        - accounts
        - hasMore
        - errors
    V1PinterestBoardsErrorDto:
      type: object
      properties:
        accountId:
          type: string
          description: O UUID da conta do Pinterest.
        message:
          type: string
          description: Por que os quadros dela estão ausentes de `data`.
          example: >-
            Pinterest refused access to the boards of this account. Reconnect
            the account.
      required:
        - accountId
        - message
  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.