> ## 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 de tous les comptes Pinterest

> Les tableaux de tous les comptes Pinterest connectés de l'espace de travail, chacun avec le compte auquel il appartient. Prévu pour un sélecteur qui ne peut pas transmettre de compte, comme un champ Make ; sinon, utilisez GET /v1/accounts/{id}/pinterest/boards. Publiez sur un tableau depuis son propre compte. Un compte dont les tableaux ne peuvent pas être lus figure dans `meta.errors`, et les tableaux des autres comptes sont tout de même renvoyés.



## OpenAPI

````yaml /fr/openapi.json get /v1/accounts/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/pinterest/boards:
    get:
      tags:
        - Accounts
      summary: Lister les tableaux Pinterest de tous les comptes Pinterest
      description: >-
        Les tableaux de tous les comptes Pinterest connectés de l'espace de
        travail, chacun avec le compte auquel il appartient. Prévu pour un
        sélecteur qui ne peut pas transmettre de compte, comme un champ Make ;
        sinon, utilisez GET /v1/accounts/{id}/pinterest/boards. Publiez sur un
        tableau depuis son propre compte. Un compte dont les tableaux ne peuvent
        pas être lus figure dans `meta.errors`, et les tableaux des autres
        comptes sont tout de même renvoyés.
      operationId: V1AccountsController_workspacePinterestBoards
      parameters: []
      responses:
        '200':
          description: Les tableaux de tous les comptes 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: >-
            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
        accountId:
          type: string
          description: >-
            L'UUID du compte Pinterest auquel appartient le tableau. Publiez sur
            le tableau depuis ce compte.
          example: 11111111-1111-4111-8111-111111111111
        accountName:
          type: string
          description: Le nom de ce compte Pinterest.
          example: mybrand
      required:
        - id
        - name
        - description
        - accountId
        - accountName
    V1WorkspacePinterestBoardsMetaDto:
      type: object
      properties:
        total:
          type: number
          description: Le nombre de tableaux dans `data`.
          example: 3
        accounts:
          type: number
          description: Le nombre de comptes Pinterest connectés.
          example: 1
        hasMore:
          type: boolean
          description: >-
            true lorsqu'un compte a plus de tableaux que Pinterest n'en renvoie
            en une fois (250). `data` contient alors ses 250 premiers.
          example: false
        errors:
          description: >-
            Les comptes dont les tableaux n'ont pas pu être lus. Les tableaux
            des autres comptes sont tout de même dans `data`.
          type: array
          items:
            $ref: '#/components/schemas/V1PinterestBoardsErrorDto'
      required:
        - total
        - accounts
        - hasMore
        - errors
    V1PinterestBoardsErrorDto:
      type: object
      properties:
        accountId:
          type: string
          description: L'UUID du compte Pinterest.
        message:
          type: string
          description: Pourquoi ses tableaux sont absents 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.