> ## 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 los tableros de Pinterest de todas las cuentas de Pinterest

> Los tableros de todas las cuentas de Pinterest conectadas del espacio de trabajo, cada uno con la cuenta a la que pertenece. Pensado para un selector que no puede indicar una cuenta, como un campo de Make; en los demás casos, usa GET /v1/accounts/{id}/pinterest/boards. Publica en un tablero desde su propia cuenta. Una cuenta cuyos tableros no se pueden leer aparece en `meta.errors`, y los tableros de las demás cuentas se devuelven igualmente.



## OpenAPI

````yaml /es/openapi.json get /v1/accounts/pinterest/boards
openapi: 3.0.0
info:
  title: Social media studio API
  description: >-
    La API de Social media studio te permite gestionar tu flujo de trabajo de
    redes sociales de forma programática: crear y programar publicaciones,
    organizar el contenido multimedia, consultar analíticas, gestionar tu equipo
    y mucho más.


    ## URL base


    ```

    https://api.so-me.studio

    ```


    ## Autenticación


    Todos los endpoints `/v1/*` requieren una clave de API enviada en la
    cabecera `X-API-Key`.


    ```

    X-API-Key: sk_live_xxxxxxxxxxxxxxxxxxxxxxxx

    ```


    ## Permisos (scopes)


    Una clave tiene acceso completo salvo que le asignes permisos al crearla.
    Una clave con permisos limitados solo puede llamar a los endpoints que esos
    permisos cubren; los demás endpoints devuelven `403 Forbidden`. Un endpoint
    `GET` necesita `<resource>:read`; `POST`, `PUT`, `PATCH` y `DELETE`
    necesitan `<resource>:write`, que incluye `read`. Recursos: `accounts`,
    `posts` (también borradores y aprobaciones), `media`, `analytics` (solo
    lectura), `inbox`, `ai`, `biolinks`, `teams`, `settings`, `webhooks`,
    `support`, `templates` (solo lectura), `whatsapp`. Los endpoints de claves
    de API y de espacio de trabajo bajo `/v1/settings`, y `PATCH
    /v1/settings/profile`, necesitan una clave con acceso completo. Las claves
    con permisos limitados no pueden usar el servidor MCP.


    ## Obtener tu clave de API


    1. Inicia sesión en tu espacio de trabajo en [Social media
    studio](https://so-me.studio/es)

    2. Ve a **Configuración** > pestaña **API**

    3. Haz clic en **Nueva clave de API**, ponle un nombre y copia la clave


    > La clave completa se muestra solo una vez. Guárdala de forma segura.


    ## Límites de frecuencia


    Por espacio de trabajo, según el plan: 30 solicitudes por minuto en Lite, 60
    en Creator y Standard, 300 en Advanced y Lifetime. Si superas el límite,
    recibirás una respuesta `429 Too Many Requests`.


    ## Planes


    El acceso a la API está incluido en todos los planes de pago: **Lite**,
    **Creator**, **Standard**, **Advanced** y **Lifetime**. La cuota mensual de
    llamadas depende del plan.
  version: '1.0'
  contact: {}
servers:
  - url: https://api.so-me.studio
    description: Producción
security: []
tags:
  - name: Posts
    description: Crear, gestionar, programar y publicar publicaciones en redes sociales
  - name: Accounts
    description: Gestionar las cuentas de redes sociales conectadas
  - name: Drafts
    description: Crear y gestionar borradores
  - name: Media
    description: Subir, organizar y gestionar archivos multimedia y carpetas
  - name: Analytics
    description: Analíticas de plataforma y de publicación en todas las cuentas sociales
  - name: Inbox
    description: >-
      Conversaciones de la bandeja de entrada social, respuestas y respuestas
      guardadas
  - name: AI
    description: Generación de texto e imágenes con IA
  - name: Approvals
    description: Flujo de aprobación de publicaciones para la colaboración en equipo
  - name: Teams
    description: Gestión de miembros del equipo e invitaciones
  - name: Biolinks
    description: Páginas de biolink con botones, publicaciones y temas
  - name: Settings
    description: Perfil, organización, claves de API, facturación y uso
  - name: Authentication
    description: >-
      Registro, inicio de sesión, restablecimiento de contraseña y autorización
      de dispositivo
  - name: Plans
    description: Planes de suscripción, funciones y complementos disponibles
  - name: Public Biolink
    description: >-
      Resolución de páginas de biolink públicas y seguimiento de analíticas (no
      requiere autenticación)
paths:
  /v1/accounts/pinterest/boards:
    get:
      tags:
        - Accounts
      summary: Listar los tableros de Pinterest de todas las cuentas de Pinterest
      description: >-
        Los tableros de todas las cuentas de Pinterest conectadas del espacio de
        trabajo, cada uno con la cuenta a la que pertenece. Pensado para un
        selector que no puede indicar una cuenta, como un campo de Make; en los
        demás casos, usa GET /v1/accounts/{id}/pinterest/boards. Publica en un
        tablero desde su propia cuenta. Una cuenta cuyos tableros no se pueden
        leer aparece en `meta.errors`, y los tableros de las demás cuentas se
        devuelven igualmente.
      operationId: V1AccountsController_workspacePinterestBoards
      parameters: []
      responses:
        '200':
          description: Los tableros de todas las cuentas de 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: >-
            El ID del tablero. Envíalo como `metaData.boardId` al crear una
            publicación de Pinterest.
          example: '1234567890123456789'
        name:
          type: string
          description: El nombre del tablero.
          example: Recipes
        description:
          type: string
          nullable: true
          description: La descripción del tablero, o null si no tiene.
          example: null
        privacy:
          type: string
          description: Quién puede ver el tablero.
          enum:
            - PUBLIC
            - PROTECTED
            - SECRET
          example: PUBLIC
        accountId:
          type: string
          description: >-
            El UUID de la cuenta de Pinterest a la que pertenece el tablero.
            Publica en el tablero desde esta cuenta.
          example: 11111111-1111-4111-8111-111111111111
        accountName:
          type: string
          description: El nombre de esa cuenta de Pinterest.
          example: mybrand
      required:
        - id
        - name
        - description
        - accountId
        - accountName
    V1WorkspacePinterestBoardsMetaDto:
      type: object
      properties:
        total:
          type: number
          description: El número de tableros en `data`.
          example: 3
        accounts:
          type: number
          description: El número de cuentas de Pinterest conectadas.
          example: 1
        hasMore:
          type: boolean
          description: >-
            true cuando una cuenta tiene más tableros de los que Pinterest
            devuelve de una vez (250). En ese caso, `data` contiene sus primeros
            250.
          example: false
        errors:
          description: >-
            Las cuentas cuyos tableros no se pudieron leer. Los tableros de las
            demás cuentas siguen en `data`.
          type: array
          items:
            $ref: '#/components/schemas/V1PinterestBoardsErrorDto'
      required:
        - total
        - accounts
        - hasMore
        - errors
    V1PinterestBoardsErrorDto:
      type: object
      properties:
        accountId:
          type: string
          description: El UUID de la cuenta de Pinterest.
        message:
          type: string
          description: Por qué faltan sus tableros en `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.