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

# Pinterest-Boards aller Pinterest-Konten auflisten

> Die Boards aller verbundenen Pinterest-Konten des Workspace, jeweils mit dem Konto, dem sie gehören. Für eine Auswahl, die kein Konto übergeben kann, etwa ein Make-Feld; sonst verwende GET /v1/accounts/{id}/pinterest/boards. Poste auf ein Board von seinem eigenen Konto aus. Ein Konto, dessen Boards sich nicht lesen lassen, steht in `meta.errors`, und die Boards der anderen Konten werden trotzdem zurückgegeben.



## OpenAPI

````yaml /de/openapi.json get /v1/accounts/pinterest/boards
openapi: 3.0.0
info:
  title: Social media studio API
  description: >-
    Die Social media studio API ermöglicht es dir, deinen Social-Media-Workflow
    programmatisch zu steuern – Beiträge erstellen und planen, Medien
    organisieren, Analysen abrufen, dein Team verwalten und mehr.


    ## Basis-URL


    ```

    https://api.so-me.studio

    ```


    ## Authentifizierung


    Alle `/v1/*`-Endpunkte erfordern einen API-Schlüssel, der im Header
    `X-API-Key` übergeben wird.


    ```

    X-API-Key: sk_live_xxxxxxxxxxxxxxxxxxxxxxxx

    ```


    ## Scopes


    Ein Schlüssel hat vollen Zugriff, es sei denn, du vergibst beim Erstellen
    Scopes. Ein Schlüssel mit Scopes kann nur die Endpunkte aufrufen, die seine
    Scopes abdecken; andere Endpunkte liefern `403 Forbidden`. Ein
    `GET`-Endpunkt benötigt `<resource>:read`; `POST`, `PUT`, `PATCH` und
    `DELETE` benötigen `<resource>:write`, was `read` einschließt. Ressourcen:
    `accounts`, `posts` (auch Entwürfe und Freigaben), `media`, `analytics` (nur
    lesend), `inbox`, `ai`, `biolinks`, `teams`, `settings`, `webhooks`,
    `support`, `templates` (nur lesend), `whatsapp`. Die Endpunkte für
    API-Schlüssel und Workspaces unter `/v1/settings` sowie `PATCH
    /v1/settings/profile` erfordern einen Schlüssel mit vollem Zugriff.
    Schlüssel mit Scopes können den MCP-Server nicht nutzen.


    ## API-Schlüssel erhalten


    1. Melde dich bei deinem Workspace in [Social media
    studio](https://so-me.studio/de) an

    2. Gehe zu **Einstellungen** > Tab **API**

    3. Klicke auf **Neuer API-Schlüssel**, vergib einen Namen und kopiere den
    Schlüssel


    > Der vollständige Schlüssel wird nur einmal angezeigt. Bewahre ihn sicher
    auf.


    ## Rate Limits


    Pro Workspace, je nach Tarif: 30 Anfragen pro Minute in Lite, 60 in Creator
    und Standard, 300 in Advanced und Lifetime. Wenn du das Limit
    überschreitest, erhältst du eine Antwort `429 Too Many Requests`.


    ## Tarife


    Der API-Zugriff ist in jedem bezahlten Tarif enthalten: **Lite**,
    **Creator**, **Standard**, **Advanced** und **Lifetime**. Das monatliche
    Aufrufkontingent hängt vom Tarif ab.
  version: '1.0'
  contact: {}
servers:
  - url: https://api.so-me.studio
    description: Produktion
security: []
tags:
  - name: Posts
    description: Social-Media-Beiträge erstellen, verwalten, planen und veröffentlichen
  - name: Accounts
    description: Verbundene Social-Media-Konten verwalten
  - name: Drafts
    description: Entwürfe erstellen und verwalten
  - name: Media
    description: Mediendateien und Ordner hochladen, organisieren und verwalten
  - name: Analytics
    description: >-
      Analysen auf Plattform- und Beitragsebene über alle Social-Media-Konten
      hinweg
  - name: Inbox
    description: >-
      Unterhaltungen, Antworten und gespeicherte Antworten im
      Social-Media-Posteingang
  - name: AI
    description: KI-gestützte Text- und Bildgenerierung
  - name: Approvals
    description: Freigabe-Workflow für Beiträge zur Zusammenarbeit im Team
  - name: Teams
    description: Verwaltung von Teammitgliedern und Einladungen
  - name: Biolinks
    description: Biolink-Seiten mit Buttons, Beiträgen und Themes
  - name: Settings
    description: Profil, Organisation, API-Schlüssel, Abrechnung und Nutzung
  - name: Authentication
    description: Registrierung, Anmeldung, Passwort zurücksetzen und Geräte-Autorisierung
  - name: Plans
    description: Verfügbare Abonnement-Tarife, Funktionen und Add-ons
  - name: Public Biolink
    description: >-
      Auflösung öffentlicher Biolink-Seiten und Analyse-Tracking (keine
      Authentifizierung erforderlich)
paths:
  /v1/accounts/pinterest/boards:
    get:
      tags:
        - Accounts
      summary: Pinterest-Boards aller Pinterest-Konten auflisten
      description: >-
        Die Boards aller verbundenen Pinterest-Konten des Workspace, jeweils mit
        dem Konto, dem sie gehören. Für eine Auswahl, die kein Konto übergeben
        kann, etwa ein Make-Feld; sonst verwende GET
        /v1/accounts/{id}/pinterest/boards. Poste auf ein Board von seinem
        eigenen Konto aus. Ein Konto, dessen Boards sich nicht lesen lassen,
        steht in `meta.errors`, und die Boards der anderen Konten werden
        trotzdem zurückgegeben.
      operationId: V1AccountsController_workspacePinterestBoards
      parameters: []
      responses:
        '200':
          description: Die Boards aller Pinterest-Konten
          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: >-
            Die Board-ID. Sende sie als `metaData.boardId`, wenn du einen
            Pinterest-Beitrag erstellst.
          example: '1234567890123456789'
        name:
          type: string
          description: Der Name des Boards.
          example: Recipes
        description:
          type: string
          nullable: true
          description: Die Beschreibung des Boards oder null, wenn es keine hat.
          example: null
        privacy:
          type: string
          description: Wer das Board sehen kann.
          enum:
            - PUBLIC
            - PROTECTED
            - SECRET
          example: PUBLIC
        accountId:
          type: string
          description: >-
            Die UUID des Pinterest-Kontos, dem das Board gehört. Poste von
            diesem Konto aus auf das Board.
          example: 11111111-1111-4111-8111-111111111111
        accountName:
          type: string
          description: Der Name dieses Pinterest-Kontos.
          example: mybrand
      required:
        - id
        - name
        - description
        - accountId
        - accountName
    V1WorkspacePinterestBoardsMetaDto:
      type: object
      properties:
        total:
          type: number
          description: Die Anzahl der Boards in `data`.
          example: 3
        accounts:
          type: number
          description: Die Anzahl der verbundenen Pinterest-Konten.
          example: 1
        hasMore:
          type: boolean
          description: >-
            true, wenn ein Konto mehr Boards hat, als Pinterest auf einmal
            zurückgibt (250). `data` enthält dann seine ersten 250.
          example: false
        errors:
          description: >-
            Die Konten, deren Boards nicht gelesen werden konnten. Die Boards
            der anderen Konten sind trotzdem in `data`.
          type: array
          items:
            $ref: '#/components/schemas/V1PinterestBoardsErrorDto'
      required:
        - total
        - accounts
        - hasMore
        - errors
    V1PinterestBoardsErrorDto:
      type: object
      properties:
        accountId:
          type: string
          description: Die UUID des Pinterest-Kontos.
        message:
          type: string
          description: Warum seine Boards in `data` fehlen.
          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.