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

# Lister les tableaux Pinterest d'un compte

> Pinterest refuse une épingle sans tableau : lisez donc cette route avant de créer une publication Pinterest, puis envoyez l'ID du tableau choisi dans `metaData.boardId`. La liste comprend les tableaux secrets et les tableaux auxquels le compte collabore, jusqu'à 250, et correspond à l'outil MCP list_pinterest_boards.



## OpenAPI

````yaml /fr/openapi.json get /v1/accounts/{id}/pinterest/boards
openapi: 3.0.0
info:
  title: Social media studio API
  description: >-
    L'API de Social media studio vous permet de gérer par programmation tout
    votre workflow de réseaux sociaux : créer et programmer des publications,
    organiser vos médias, suivre vos statistiques, gérer votre équipe, et plus
    encore.


    ## URL de base


    ```

    https://api.so-me.studio

    ```


    ## Authentification


    Tous les endpoints `/v1/*` exigent une clé d'API transmise dans l'en-tête
    `X-API-Key`.


    ```

    X-API-Key: sk_live_xxxxxxxxxxxxxxxxxxxxxxxx

    ```


    ## Scopes


    Une clé a un accès complet, sauf si vous lui donnez des scopes lors de sa
    création. Une clé limitée à certains scopes ne peut appeler que les
    endpoints couverts par ses scopes ; les autres endpoints renvoient `403
    Forbidden`. Un endpoint `GET` exige `<resource>:read` ; `POST`, `PUT`,
    `PATCH` et `DELETE` exigent `<resource>:write`, qui inclut `read`.
    Ressources : `accounts`, `posts` (également les brouillons et les
    approbations), `media`, `analytics` (lecture seule), `inbox`, `ai`,
    `biolinks`, `teams`, `settings`, `webhooks`, `support`, `templates` (lecture
    seule), `whatsapp`. Les endpoints de clés d'API et d'espace de travail sous
    `/v1/settings`, ainsi que `PATCH /v1/settings/profile`, exigent une clé à
    accès complet. Les clés limitées à certains scopes ne peuvent pas utiliser
    le serveur MCP.


    ## Obtenir votre clé d'API


    1. Connectez-vous à votre espace de travail sur [Social media
    studio](https://so-me.studio)

    2. Allez dans **Paramètres** > onglet **API**

    3. Cliquez sur **Nouvelle clé API**, donnez-lui un nom et copiez la clé


    > La clé complète n'est affichée qu'une seule fois. Conservez-la en lieu
    sûr.


    ## Limites de débit


    Par espace de travail, selon la formule : 30 requêtes par minute avec Lite,
    60 avec Creator et Standard, 300 avec Advanced et Lifetime. Au-delà, vous
    recevrez une réponse `429 Too Many Requests`.


    ## Forfaits


    L'accès à l'API est inclus dans toutes les formules payantes : **Lite**,
    **Creator**, **Standard**, **Advanced** et **Lifetime**. Le quota mensuel
    d'appels dépend de la formule.
  version: '1.0'
  contact: {}
servers:
  - url: https://api.so-me.studio
    description: Production
security: []
tags:
  - name: Posts
    description: >-
      Créer, gérer, programmer et publier des publications sur les réseaux
      sociaux
  - name: Accounts
    description: Gérer les comptes de réseaux sociaux connectés
  - name: Drafts
    description: Créer et gérer des brouillons
  - name: Media
    description: Téléverser, organiser et gérer des fichiers et dossiers multimédias
  - name: Analytics
    description: >-
      Statistiques au niveau des plateformes et des publications pour les
      comptes sociaux
  - name: Inbox
    description: >-
      Conversations de la boîte de réception sociale, réponses et réponses
      enregistrées
  - name: AI
    description: Génération de texte et d'images par IA
  - name: Approvals
    description: Workflow d'approbation des publications pour la collaboration d'équipe
  - name: Teams
    description: Gestion des membres de l'équipe et des invitations
  - name: Biolinks
    description: Pages de lien en bio avec boutons, publications et thèmes
  - name: Settings
    description: Profil, organisation, clés d'API, facturation et utilisation
  - name: Authentication
    description: >-
      Inscription, connexion, réinitialisation du mot de passe et autorisation
      d'appareil
  - name: Plans
    description: >-
      Forfaits d'abonnement, fonctionnalités et modules complémentaires
      disponibles
  - name: Public Biolink
    description: >-
      Résolution des pages biolink publiques et suivi des statistiques (aucune
      authentification requise)
paths:
  /v1/accounts/{id}/pinterest/boards:
    get:
      tags:
        - Accounts
      summary: Lister les tableaux Pinterest d'un compte
      description: >-
        Pinterest refuse une épingle sans tableau : lisez donc cette route avant
        de créer une publication Pinterest, puis envoyez l'ID du tableau choisi
        dans `metaData.boardId`. La liste comprend les tableaux secrets et les
        tableaux auxquels le compte collabore, jusqu'à 250, et correspond à
        l'outil MCP list_pinterest_boards.
      operationId: V1AccountsController_pinterestBoards
      parameters:
        - name: id
          required: true
          in: path
          description: UUID du compte social
          schema:
            type: string
      responses:
        '200':
          description: Les tableaux du compte
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V1PinterestBoardsDto'
        '400':
          description: >-
            Le compte n'est pas un compte Pinterest, n'est pas connecté, ou
            Pinterest a refusé l'accès
        '404':
          description: Compte introuvable
      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: >-
            L'ID du tableau. Envoyez-le dans `metaData.boardId` lorsque vous
            créez une publication Pinterest.
          example: '1234567890123456789'
        name:
          type: string
          description: Le nom du tableau.
          example: Recipes
        description:
          type: string
          nullable: true
          description: La description du tableau, ou null s'il n'en a pas.
          example: null
        privacy:
          type: string
          description: Qui peut voir le tableau.
          enum:
            - PUBLIC
            - PROTECTED
            - SECRET
          example: PUBLIC
      required:
        - id
        - name
        - description
    V1PinterestBoardsMetaDto:
      type: object
      properties:
        total:
          type: number
          description: Le nombre de tableaux dans `data`.
          example: 1
        hasMore:
          type: boolean
          description: >-
            true lorsque le compte a plus de tableaux que Pinterest n'en renvoie
            en une fois (250). `data` contient alors les 250 premiers.
          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.