> ## 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. # নতুন পোস্ট তৈরি করুন > ঐচ্ছিক মিডিয়া ফাইলসহ একটি পোস্ট তৈরি করুন। মিডিয়া সংযুক্ত করতে প্রথমে আপলোড URL পেতে POST /v1/posts/presign-media কল করুন, আপনার ফাইল S3-এ আপলোড করুন, তারপর এখানে ফাইলের রেফারেন্স দিন। ## OpenAPI ````yaml /bn/openapi.json post /v1/posts 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` এন্ডপয়েন্টের জন্য `:read` লাগে; `POST`, `PUT`, `PATCH` ও `DELETE`-এর জন্য `: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 কী**-তে ক্লিক করুন, একটি নাম দিন এবং কীটি কপি করুন > সম্পূর্ণ কী শুধু একবারই দেখানো হয়। এটি নিরাপদে রাখুন। ## রেট লিমিট প্রতি ওয়ার্কস্পেসে প্রতি মিনিটে 60টি রিকোয়েস্ট। এটি ছাড়ালে আপনি `429 Too Many Requests` রেসপন্স পাবেন। ## প্ল্যান API অ্যাক্সেস **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/posts: post: tags: - Posts summary: নতুন পোস্ট তৈরি করুন description: >- ঐচ্ছিক মিডিয়া ফাইলসহ একটি পোস্ট তৈরি করুন। মিডিয়া সংযুক্ত করতে প্রথমে আপলোড URL পেতে POST /v1/posts/presign-media কল করুন, আপনার ফাইল S3-এ আপলোড করুন, তারপর এখানে ফাইলের রেফারেন্স দিন। operationId: V1PostsController_create parameters: [] requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreateV1PostDto' responses: '201': description: পোস্ট তৈরি হয়েছে '400': description: ভ্যালিডেশন ত্রুটি security: - X-API-Key: [] components: schemas: CreateV1PostDto: type: object properties: text: type: string description: পোস্টের টেক্সট কনটেন্ট socialMedia: enum: - TWITTER - INSTAGRAM - LINKEDIN - LINKEDIN_PAGE - FACEBOOK - TIKTOK - YOUTUBE - THREADS - WHATSAPP type: string description: লক্ষ্য সোশ্যাল মিডিয়া প্ল্যাটফর্ম postType: enum: - TEXT - IMAGE - MULTIPLE_IMAGES - VIDEO - CAROUSEL - REEL - STORY type: string description: পোস্টের ধরন (IMAGE, VIDEO, CAROUSEL, REEL, STORY, TEXT) scheduledAt: type: string description: শিডিউলের জন্য ISO 8601 তারিখ (ভবিষ্যতে হতে হবে) metaData: type: object description: প্ল্যাটফর্ম-নির্দিষ্ট মেটাডেটা files: description: >- সংযুক্ত করার মিডিয়া ফাইল (s3Prefix ও fileSrc পেতে আগে presign-media ব্যবহার করুন) type: array items: $ref: '#/components/schemas/V1FileDto' accountId: type: string description: যে সোশ্যাল অ্যাকাউন্ট থেকে পোস্ট করবেন তার ID required: - text - socialMedia - postType V1FileDto: type: object properties: id: type: string format: uuid description: presign-media থেকে ফেরত পাওয়া ফাইলের UUID filename: type: string description: মূল ফাইলের নাম mimetype: type: string description: MIME টাইপ (যেমন image/jpeg, video/mp4) size: type: number description: বাইটে ফাইলের আকার s3Prefix: type: string description: presign-media রেসপন্স থেকে S3 অবজেক্ট কী fileSrc: type: string description: presign-media রেসপন্স থেকে CDN URL duration: type: number minimum: 0.1 maximum: 86400 description: সেকেন্ডে ভিডিওর সময়কাল (ভিডিও ফাইলের জন্য আবশ্যক) required: - filename - mimetype - size 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.