> ## 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 অ্যাকাউন্টের Pinterest বোর্ডের তালিকা

> ওয়ার্কস্পেসের প্রতিটি সংযুক্ত Pinterest অ্যাকাউন্টের বোর্ড, প্রতিটির সঙ্গে সেই বোর্ডের মালিক অ্যাকাউন্ট। এমন পিকারের জন্য, যেটি কোনো অ্যাকাউন্ট পাঠাতে পারে না, যেমন Make-এর একটি ফিল্ড; অন্য ক্ষেত্রে GET /v1/accounts/{id}/pinterest/boards ব্যবহার করুন। কোনো বোর্ডে সেই বোর্ডের নিজের অ্যাকাউন্ট থেকে পোস্ট করুন। যে অ্যাকাউন্টের বোর্ড পড়া যায় না, সেটি `meta.errors`-এ থাকে, আর অন্য অ্যাকাউন্টগুলোর বোর্ড তবুও ফেরত আসে।



## OpenAPI

````yaml /bn/openapi.json get /v1/accounts/pinterest/boards
openapi: 3.0.0
info:
  title: Social media studio API
  description: >-
    Social media studio API আপনাকে প্রোগ্রাম্যাটিকভাবে আপনার সোশ্যাল মিডিয়া
    ওয়ার্কফ্লো পরিচালনা করতে দেয় — পোস্ট তৈরি ও শিডিউল, মিডিয়া সাজানো,
    অ্যানালিটিক্স ট্র্যাক, টিম পরিচালনা এবং আরও অনেক কিছু।


    ## Base URL


    ```

    https://api.so-me.studio

    ```


    ## অথেনটিকেশন


    সব `/v1/*` এন্ডপয়েন্টে `X-API-Key` হেডারের মাধ্যমে পাঠানো একটি API কী লাগে।


    ```

    X-API-Key: sk_live_xxxxxxxxxxxxxxxxxxxxxxxx

    ```


    ## Scopes


    তৈরির সময় স্কোপ না দিলে একটি কী-র সম্পূর্ণ অ্যাক্সেস থাকে। স্কোপযুক্ত একটি
    কী শুধু সেই এন্ডপয়েন্টগুলোই কল করতে পারে যেগুলো তার স্কোপের আওতায় পড়ে;
    অন্য এন্ডপয়েন্ট `403 Forbidden` ফেরত দেয়। `GET` এন্ডপয়েন্টের জন্য
    `<resource>:read` লাগে; `POST`, `PUT`, `PATCH` ও `DELETE`-এর জন্য
    `<resource>:write` লাগে, যার মধ্যে `read` অন্তর্ভুক্ত। রিসোর্স: `accounts`,
    `posts` (ড্রাফট ও অনুমোদনসহ), `media`, `analytics` (শুধু পড়া), `inbox`,
    `ai`, `biolinks`, `teams`, `settings`, `webhooks`, `support`, `templates`
    (শুধু পড়া), `whatsapp`। `/v1/settings`-এর অধীনে API কী ও ওয়ার্কস্পেসের
    এন্ডপয়েন্ট এবং `PATCH /v1/settings/profile`-এর জন্য সম্পূর্ণ অ্যাক্সেসের কী
    লাগে। স্কোপযুক্ত কী MCP সার্ভার ব্যবহার করতে পারে না।


    ## আপনার API কী পাওয়া


    1. আপনার ওয়ার্কস্পেসে [Social media studio](https://so-me.studio)-তে লগ ইন
    করুন

    2. **সেটিংস** > **API** ট্যাবে যান

    3. **নতুন API কী**-তে ক্লিক করুন, একটি নাম দিন এবং কীটি কপি করুন


    > সম্পূর্ণ কী শুধু একবারই দেখানো হয়। এটি নিরাপদে রাখুন।


    ## রেট লিমিট


    প্রতি ওয়ার্কস্পেসে, প্ল্যান অনুযায়ী: Lite-এ প্রতি মিনিটে 30টি রিকোয়েস্ট,
    Creator ও Standard-এ 60টি, Advanced ও Lifetime-এ 300টি। সীমা ছাড়ালে আপনি
    `429 Too Many Requests` রেসপন্স পাবেন।


    ## প্ল্যান


    API অ্যাক্সেস প্রতিটি পেইড প্ল্যানে অন্তর্ভুক্ত: **Lite**, **Creator**,
    **Standard**, **Advanced** ও **Lifetime**। মাসিক কল কোটা প্ল্যানের উপর
    নির্ভর করে।
  version: '1.0'
  contact: {}
servers:
  - url: https://api.so-me.studio
    description: প্রোডাকশন
security: []
tags:
  - name: Posts
    description: সোশ্যাল মিডিয়া পোস্ট তৈরি, পরিচালনা, শিডিউল ও পাবলিশ করুন
  - name: Accounts
    description: সংযুক্ত সোশ্যাল মিডিয়া অ্যাকাউন্ট পরিচালনা করুন
  - name: Drafts
    description: ড্রাফট পোস্ট তৈরি ও পরিচালনা করুন
  - name: Media
    description: মিডিয়া ফাইল ও ফোল্ডার আপলোড, সাজানো ও পরিচালনা করুন
  - name: Analytics
    description: সোশ্যাল অ্যাকাউন্টজুড়ে প্ল্যাটফর্ম ও পোস্ট-স্তরের অ্যানালিটিক্স
  - name: Inbox
    description: সোশ্যাল ইনবক্সের কথোপকথন, উত্তর ও সেভ করা উত্তর
  - name: AI
    description: AI-চালিত টেক্সট ও ছবি জেনারেশন
  - name: Approvals
    description: টিম সহযোগিতার জন্য পোস্ট অনুমোদনের ওয়ার্কফ্লো
  - name: Teams
    description: টিম সদস্য ও আমন্ত্রণ ব্যবস্থাপনা
  - name: Biolinks
    description: বোতাম, পোস্ট ও থিমসহ বায়ো লিংক পেজ
  - name: Settings
    description: প্রোফাইল, প্রতিষ্ঠান, API কী, বিলিং ও ব্যবহার
  - name: Authentication
    description: নিবন্ধন, লগইন, পাসওয়ার্ড রিসেট ও ডিভাইস অথরাইজেশন
  - name: Plans
    description: উপলব্ধ সাবস্ক্রিপশন প্ল্যান, ফিচার ও অ্যাড-অন
  - name: Public Biolink
    description: >-
      পাবলিক বায়োলিংক পেজ রেজোলিউশন ও অ্যানালিটিক্স ট্র্যাকিং (কোনো অথেনটিকেশন
      লাগে না)
paths:
  /v1/accounts/pinterest/boards:
    get:
      tags:
        - Accounts
      summary: প্রতিটি Pinterest অ্যাকাউন্টের Pinterest বোর্ডের তালিকা
      description: >-
        ওয়ার্কস্পেসের প্রতিটি সংযুক্ত Pinterest অ্যাকাউন্টের বোর্ড, প্রতিটির
        সঙ্গে সেই বোর্ডের মালিক অ্যাকাউন্ট। এমন পিকারের জন্য, যেটি কোনো
        অ্যাকাউন্ট পাঠাতে পারে না, যেমন Make-এর একটি ফিল্ড; অন্য ক্ষেত্রে GET
        /v1/accounts/{id}/pinterest/boards ব্যবহার করুন। কোনো বোর্ডে সেই বোর্ডের
        নিজের অ্যাকাউন্ট থেকে পোস্ট করুন। যে অ্যাকাউন্টের বোর্ড পড়া যায় না,
        সেটি `meta.errors`-এ থাকে, আর অন্য অ্যাকাউন্টগুলোর বোর্ড তবুও ফেরত আসে।
      operationId: V1AccountsController_workspacePinterestBoards
      parameters: []
      responses:
        '200':
          description: প্রতিটি 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: >-
            বোর্ডের ID। Pinterest পোস্ট তৈরির সময় এটি `metaData.boardId` হিসেবে
            পাঠান।
          example: '1234567890123456789'
        name:
          type: string
          description: বোর্ডের নাম।
          example: Recipes
        description:
          type: string
          nullable: true
          description: বোর্ডের বিবরণ, না থাকলে null।
          example: null
        privacy:
          type: string
          description: কারা বোর্ডটি দেখতে পারে।
          enum:
            - PUBLIC
            - PROTECTED
            - SECRET
          example: PUBLIC
        accountId:
          type: string
          description: >-
            যে Pinterest অ্যাকাউন্ট বোর্ডটির মালিক, তার UUID। এই অ্যাকাউন্ট থেকে
            বোর্ডে পোস্ট করুন।
          example: 11111111-1111-4111-8111-111111111111
        accountName:
          type: string
          description: সেই Pinterest অ্যাকাউন্টের নাম।
          example: mybrand
      required:
        - id
        - name
        - description
        - accountId
        - accountName
    V1WorkspacePinterestBoardsMetaDto:
      type: object
      properties:
        total:
          type: number
          description: '`data`-তে থাকা বোর্ডের সংখ্যা।'
          example: 3
        accounts:
          type: number
          description: সংযুক্ত Pinterest অ্যাকাউন্টের সংখ্যা।
          example: 1
        hasMore:
          type: boolean
          description: >-
            কোনো অ্যাকাউন্টে Pinterest একবারে যতগুলো বোর্ড ফেরত দেয় (২৫০), তার
            চেয়ে বেশি বোর্ড থাকলে true। তখন `data`-তে তার প্রথম ২৫০টি থাকে।
          example: false
        errors:
          description: >-
            যেসব অ্যাকাউন্টের বোর্ড পড়া যায়নি। অন্য অ্যাকাউন্টগুলোর বোর্ড তবুও
            `data`-তে থাকে।
          type: array
          items:
            $ref: '#/components/schemas/V1PinterestBoardsErrorDto'
      required:
        - total
        - accounts
        - hasMore
        - errors
    V1PinterestBoardsErrorDto:
      type: object
      properties:
        accountId:
          type: string
          description: Pinterest অ্যাকাউন্টের UUID।
        message:
          type: string
          description: কেন এর বোর্ডগুলো `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.