> ## Documentation Index > Fetch the complete documentation index at: https://aisa.one/docs/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > - Base URLs: models `https://api.aisa.one/v1` (Gemini GenerateContent: `https://api.aisa.one/v1beta`); data APIs `https://api.aisa.one/apis/v1`. The `servers` of each operation in https://aisa.one/openapi.yaml is authoritative. > - Auth: `Authorization: Bearer $AISA_API_KEY`. Never print, log, or commit the key. > - MCP (preferred for agents): `https://mcp.aisa.one/mcp`, signed in with OAuth, so there is no key to paste. > - Agent Skill: `npx skills add AIsa-team/agent-skills --skill aisa`. Fallback with the AIsa CLI: `aisa skills install aisa`. > - Spending: docs, https://aisa.one/models, https://aisa.one/api, `/v1/models`, and MCP `search`, `list_categories`, `get_details`, `batch_quote`, and the `account` operation are free. Quote the exact calls before running them (MCP `batch_quote`, CLI `aisa quote --json`). If the quote reports `auto_execute_eligible: true`, run it unless the user set a tighter limit or asked only for a quote. Otherwise, tell the user in one message the planned calls, the quoted price, and a total USD budget for the task, then wait for approval. Direct HTTP calls follow the stricter rule at https://aisa.one/docs/get-started/cli.md#direct-http-fallback. Do not make paid calls to test availability. Full rule: https://aisa.one/llms.txt # Create a post > Creates a draft, a scheduled post, or publishes now. Drafts stay in AIsa until scheduled or published. Returns 201, 207 when some platforms failed synchronously, or 202 with status publishing or scheduled while the outcome is pending. A replay of an idempotent request returns 200 with the original post. A request reference price is not currently available; use a request quote where supported. Account-specific pricing and final settlement may differ. ## Request contract * **Method and path:** POST /apis/v1/social/posts * **Availability:** enabled * **Request URL template:** `https://api.aisa.one/apis/v1/social/posts` * **Idempotency-Key:** header; optional * **Runtime facts:** 99acb5bddbedc8d3352e7c4fef86c3e6d8852c14772bcd18dbcf415237a642bd [Complete OpenAPI definition](https://aisa.one/docs/reference-contracts/aisa-social.json) Effective request and pricing declaration (including authentication and referenced schemas): ```json theme={null} { "operationId": "post_aisa_social_apis_v1_social_posts", "method": "POST", "path": "/apis/v1/social/posts", "servers": [ { "url": "https://api.aisa.one" } ], "parameters": [ { "description": "Strongly recommended. Reusing a key within 24 hours returns the original result; a different body returns 409 idempotency_key_reused. Without a key the server derives one from the body in 10-minute buckets and echoes it in the response header.", "in": "header", "name": "Idempotency-Key", "required": false, "schema": { "maxLength": 191, "minLength": 1, "type": "string" } } ], "security": [ { "bearerAuth": [] } ], "requestBody": { "content": { "application/json": { "example": { "content": "Our spring collection is live.", "mediaItems": [ { "mediaId": "med_5Tc8Hn2Wq7Lx3Bv9Kd4Fr6", "type": "video" } ], "platforms": [ { "accountId": "acc_7Hq2Lm9Xc4Rt8Vw1Nb6Ks3", "platform": "tiktok", "platformSpecificData": { "privacyLevel": "PUBLIC_TO_EVERYONE" } } ], "profileId": "prf_2Bn8Wq5Td1Yh7Kc3Mz9Lp4", "scheduledFor": "2026-11-20T15:00:00Z", "timezone": "America/New_York" }, "schema": { "additionalProperties": false, "properties": { "content": { "type": [ "string", "null" ] }, "isDraft": { "type": [ "boolean", "null" ] }, "mediaItems": { "items": { "additionalProperties": false, "properties": { "altText": { "type": [ "string", "null" ] }, "mediaId": { "pattern": "^med_[0-9A-Za-z]{22}$", "type": [ "string", "null" ] }, "thumbnailUrl": { "type": [ "string", "null" ] }, "title": { "type": [ "string", "null" ] }, "type": { "type": [ "string", "null" ] }, "url": { "type": [ "string", "null" ] } }, "type": [ "object", "null" ] }, "type": [ "array", "null" ] }, "platforms": { "items": { "additionalProperties": false, "allOf": [ { "if": { "properties": { "platform": { "enum": [ "tiktok" ] } }, "required": [ "platform" ] }, "then": { "properties": { "platformSpecificData": { "anyOf": [ { "type": "null" }, { "additionalProperties": false, "description": "Required to schedule or publish: privacyLevel, allowComment. Also required for video: allowDuet, allowStitch. Must be true, from the user: contentPreviewConfirmed, expressConsentGiven.", "properties": { "allowComment": { "description": "Allow comments. Must be false when creator-info reports commentDisabled.", "type": "boolean" }, "allowDuet": { "description": "Allow duets; required for video. Must be false when creator-info reports duetDisabled.", "type": "boolean" }, "allowStitch": { "description": "Allow stitches; required for video. Must be false when creator-info reports stitchDisabled.", "type": "boolean" }, "brandPartnerPromote": { "description": "Also disclose a paid partnership; only alongside commercialContentType brand_organic.", "type": "boolean" }, "commercialContentType": { "description": "Commercial content disclosure; one of commercialContentTypes from creator-info. brand_content cannot be SELF_ONLY.", "enum": [ "none", "brand_organic", "brand_content" ], "type": "string" }, "contentPreviewConfirmed": { "description": "The user previewed exactly this content. Must be true and must come from the user.", "type": "boolean" }, "description": { "description": "Long caption for photo posts.", "maxLength": 4000, "minLength": 1, "type": "string" }, "expressConsentGiven": { "description": "The user consented to posting. Must be true and must come from the user.", "type": "boolean" }, "isBrandOrganicPost": { "description": "Also disclose the creator's own brand; only alongside commercialContentType brand_content.", "type": "boolean" }, "mediaType": { "description": "Overrides the media type derived from the media items.", "enum": [ "video", "photo" ], "type": "string" }, "privacyLevel": { "description": "One of privacyLevelOptions from GET /accounts/{accountId}/tiktok/creator-info for this mediaType.", "maxLength": 64, "minLength": 1, "type": "string" }, "videoMadeWithAi": { "description": "Label the post as AI-generated.", "type": "boolean" } }, "type": "object" } ] } } } }, { "if": { "properties": { "platform": { "enum": [ "instagram" ] } }, "required": [ "platform" ] }, "then": { "properties": { "platformSpecificData": { "anyOf": [ { "type": "null" }, { "additionalProperties": false, "description": "", "properties": { "collaborators": { "description": "Up to 3 usernames to invite as collaborators (feed and Reels).", "items": { "maxLength": 64, "minLength": 1, "type": "string" }, "maxItems": 3, "type": "array" }, "contentType": { "description": "story publishes a Story.", "enum": [ "story" ], "type": "string" }, "firstComment": { "description": "First comment added after publishing (not on Stories).", "maxLength": 2200, "minLength": 1, "type": "string" }, "isAiGenerated": { "description": "Label the post as containing AI-generated media.", "type": "boolean" }, "shareToFeed": { "description": "Reels only: also show the Reel on the main feed (default true).", "type": "boolean" } }, "type": "object" } ] } } } }, { "if": { "properties": { "platform": { "enum": [ "twitter", "x" ] } }, "required": [ "platform" ] }, "then": { "properties": { "platformSpecificData": { "anyOf": [ { "type": "null" }, { "additionalProperties": false, "description": "", "properties": { "madeWithAi": { "description": "Label the post as containing AI-generated media.", "type": "boolean" }, "poll": { "additionalProperties": false, "description": "A poll; cannot be combined with media or threadItems.", "properties": { "duration_minutes": { "maximum": 10080, "minimum": 5, "type": "integer" }, "options": { "items": { "maxLength": 25, "minLength": 1, "type": "string" }, "maxItems": 4, "minItems": 2, "type": "array" } }, "required": [ "options", "duration_minutes" ], "type": "object" }, "replySettings": { "description": "Who can reply.", "enum": [ "following", "mentionedUsers", "subscribers", "verified" ], "type": "string" }, "threadItems": { "description": "The whole thread; the first item is the root post. Cannot be combined with poll.", "items": { "additionalProperties": false, "properties": { "content": { "description": "Text of this post.", "maxLength": 25000, "minLength": 1, "type": "string" } }, "required": [ "content" ], "type": "object" }, "minItems": 1, "type": "array" } }, "type": "object" } ] } } } }, { "if": { "properties": { "platform": { "enum": [ "youtube" ] } }, "required": [ "platform" ] }, "then": { "properties": { "platformSpecificData": { "anyOf": [ { "type": "null" }, { "additionalProperties": false, "description": "Required to schedule or publish: madeForKids.", "properties": { "containsSyntheticMedia": { "description": "Label the video as containing synthetic (AI-generated) content.", "type": "boolean" }, "firstComment": { "description": "First comment posted after upload.", "maxLength": 10000, "minLength": 1, "type": "string" }, "madeForKids": { "description": "COPPA: whether the video is made for kids. Required, and must be the user's explicit choice.", "type": "boolean" }, "title": { "description": "Video title.", "maxLength": 100, "minLength": 1, "type": "string" }, "visibility": { "description": "Video visibility.", "enum": [ "public", "private", "unlisted" ], "type": "string" } }, "type": "object" } ] } } } }, { "if": { "properties": { "platform": { "enum": [ "facebook" ] } }, "required": [ "platform" ] }, "then": { "properties": { "platformSpecificData": { "anyOf": [ { "type": "null" }, { "additionalProperties": false, "description": "", "properties": { "contentType": { "description": "story or reel; omitted is a feed post.", "enum": [ "story", "reel" ], "type": "string" }, "firstComment": { "description": "First comment added after publishing (not on stories).", "maxLength": 8000, "minLength": 1, "type": "string" }, "pageId": { "description": "Page to post to when the account manages several.", "maxLength": 64, "minLength": 1, "type": "string" } }, "type": "object" } ] } } } }, { "if": { "properties": { "platform": { "enum": [ "linkedin" ] } }, "required": [ "platform" ] }, "then": { "properties": { "platformSpecificData": { "anyOf": [ { "type": "null" }, { "additionalProperties": false, "description": "linkedin accepts no platformSpecificData yet.", "properties": {}, "type": "object" } ] } } } }, { "if": { "properties": { "platform": { "enum": [ "pinterest" ] } }, "required": [ "platform" ] }, "then": { "properties": { "platformSpecificData": { "anyOf": [ { "type": "null" }, { "additionalProperties": false, "description": "", "properties": { "isAiGenerated": { "description": "Label the Pin as AI modified.", "type": "boolean" } }, "type": "object" } ] } } } }, { "if": { "properties": { "platform": { "enum": [ "threads" ] } }, "required": [ "platform" ] }, "then": { "properties": { "platformSpecificData": { "anyOf": [ { "type": "null" }, { "additionalProperties": false, "description": "threads accepts no platformSpecificData yet.", "properties": {}, "type": "object" } ] } } } }, { "if": { "properties": { "platform": { "enum": [ "reddit" ] } }, "required": [ "platform" ] }, "then": { "properties": { "platformSpecificData": { "anyOf": [ { "type": "null" }, { "additionalProperties": false, "description": "reddit accepts no platformSpecificData yet.", "properties": {}, "type": "object" } ] } } } } ], "properties": { "accountId": { "pattern": "^acc_[0-9A-Za-z]{22}$", "type": [ "string", "null" ] }, "customContent": { "type": [ "string", "null" ] }, "customMedia": { "items": { "additionalProperties": false, "properties": { "altText": { "type": [ "string", "null" ] }, "mediaId": { "pattern": "^med_[0-9A-Za-z]{22}$", "type": [ "string", "null" ] }, "thumbnailUrl": { "type": [ "string", "null" ] }, "title": { "type": [ "string", "null" ] }, "type": { "type": [ "string", "null" ] }, "url": { "type": [ "string", "null" ] } }, "type": [ "object", "null" ] }, "type": [ "array", "null" ] }, "platform": { "enum": [ "tiktok", "instagram", "twitter", "youtube", "facebook", "linkedin", "pinterest", "threads", "reddit", "x", null ], "type": [ "string", "null" ] }, "platformSpecificData": { "additionalProperties": {}, "description": "Platform options, checked against the platform registry: unknown fields are rejected with unknown_field. The accepted fields depend on platform; fields required to schedule or publish are named in each description.", "type": [ "object", "null" ] }, "scheduledFor": { "format": "date-time", "type": [ "string", "null" ] } }, "type": [ "object", "null" ] }, "type": [ "array", "null" ] }, "profileId": { "pattern": "^prf_[0-9A-Za-z]{22}$", "type": [ "string", "null" ] }, "publishNow": { "type": [ "boolean", "null" ] }, "scheduledFor": { "format": "date-time", "type": [ "string", "null" ] }, "timezone": { "type": [ "string", "null" ] }, "title": { "type": [ "string", "null" ] } }, "type": "object" } } }, "required": true }, "x-aisa-status": "enabled", "x-aisa-pricing": { "description": "Each platform target that publishes successfully is metered once under social.post.published:, including after retries. Not charged in the current period.", "kind": "metered_event", "meter": "social.post.published" }, "components": { "securitySchemes": { "bearerAuth": { "scheme": "bearer", "type": "http" } } } } ``` ## Cost and request rules A request reference price is not currently available; use a request quote where supported. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar. ## OpenAPI ````yaml reference-contracts/aisa-social.json POST /apis/v1/social/posts openapi: 3.1.0 info: description: '' title: AIsa Social version: '1' x-aisa-capabilities: idempotency: Idempotency-Key max_price: X-AISA-Max-Price-USD quote: header: X-AISA-Cost-Mode value: quote x-aisa-configured-paths: [] x-aisa-document: facts_hash: 99acb5bddbedc8d3352e7c4fef86c3e6d8852c14772bcd18dbcf415237a642bd generator_version: '3' protocol_version: '1' schema_version: '1' composer_version: '27' response_pending: [] document_hash: sha256:7f9742cb1ea233c648dcb290fdfbf24e53a27dcf900ec1386f83a8ef2e6b1bf9 x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-provider: aisa-social x-aisa-catalogs: aisa-social: title: AIsa Social description: '' x-aisa-document: facts_hash: 99acb5bddbedc8d3352e7c4fef86c3e6d8852c14772bcd18dbcf415237a642bd generator_version: '3' protocol_version: '1' schema_version: '1' x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-capabilities: idempotency: Idempotency-Key max_price: X-AISA-Max-Price-USD quote: header: X-AISA-Cost-Mode value: quote servers: - url: https://api.aisa.one security: - bearerAuth: [] paths: /apis/v1/social/posts: post: summary: Create a post description: >- Creates a draft, a scheduled post, or publishes now. Drafts stay in AIsa until scheduled or published. Returns 201, 207 when some platforms failed synchronously, or 202 with status publishing or scheduled while the outcome is pending. A replay of an idempotent request returns 200 with the original post. A request reference price is not currently available; use a request quote where supported. Account-specific pricing and final settlement may differ. operationId: post_aisa_social_apis_v1_social_posts parameters: - description: >- Strongly recommended. Reusing a key within 24 hours returns the original result; a different body returns 409 idempotency_key_reused. Without a key the server derives one from the body in 10-minute buckets and echoes it in the response header. in: header name: Idempotency-Key required: false schema: maxLength: 191 minLength: 1 type: string requestBody: content: application/json: example: content: Our spring collection is live. mediaItems: - mediaId: med_5Tc8Hn2Wq7Lx3Bv9Kd4Fr6 type: video platforms: - accountId: acc_7Hq2Lm9Xc4Rt8Vw1Nb6Ks3 platform: tiktok platformSpecificData: privacyLevel: PUBLIC_TO_EVERYONE profileId: prf_2Bn8Wq5Td1Yh7Kc3Mz9Lp4 scheduledFor: '2026-11-20T15:00:00Z' timezone: America/New_York schema: additionalProperties: false properties: content: type: - string - 'null' isDraft: type: - boolean - 'null' mediaItems: items: additionalProperties: false properties: altText: type: - string - 'null' mediaId: pattern: ^med_[0-9A-Za-z]{22}$ type: - string - 'null' thumbnailUrl: type: - string - 'null' title: type: - string - 'null' type: type: - string - 'null' url: type: - string - 'null' type: - object - 'null' type: - array - 'null' platforms: items: additionalProperties: false allOf: - if: properties: platform: enum: - tiktok required: - platform then: properties: platformSpecificData: anyOf: - type: 'null' - additionalProperties: false description: >- Required to schedule or publish: privacyLevel, allowComment. Also required for video: allowDuet, allowStitch. Must be true, from the user: contentPreviewConfirmed, expressConsentGiven. properties: allowComment: description: >- Allow comments. Must be false when creator-info reports commentDisabled. type: boolean allowDuet: description: >- Allow duets; required for video. Must be false when creator-info reports duetDisabled. type: boolean allowStitch: description: >- Allow stitches; required for video. Must be false when creator-info reports stitchDisabled. type: boolean brandPartnerPromote: description: >- Also disclose a paid partnership; only alongside commercialContentType brand_organic. type: boolean commercialContentType: description: >- Commercial content disclosure; one of commercialContentTypes from creator-info. brand_content cannot be SELF_ONLY. enum: - none - brand_organic - brand_content type: string contentPreviewConfirmed: description: >- The user previewed exactly this content. Must be true and must come from the user. type: boolean description: description: Long caption for photo posts. maxLength: 4000 minLength: 1 type: string expressConsentGiven: description: >- The user consented to posting. Must be true and must come from the user. type: boolean isBrandOrganicPost: description: >- Also disclose the creator's own brand; only alongside commercialContentType brand_content. type: boolean mediaType: description: >- Overrides the media type derived from the media items. enum: - video - photo type: string privacyLevel: description: >- One of privacyLevelOptions from GET /accounts/{accountId}/tiktok/creator-info for this mediaType. maxLength: 64 minLength: 1 type: string videoMadeWithAi: description: Label the post as AI-generated. type: boolean type: object - if: properties: platform: enum: - instagram required: - platform then: properties: platformSpecificData: anyOf: - type: 'null' - additionalProperties: false description: '' properties: collaborators: description: >- Up to 3 usernames to invite as collaborators (feed and Reels). items: maxLength: 64 minLength: 1 type: string maxItems: 3 type: array contentType: description: story publishes a Story. enum: - story type: string firstComment: description: >- First comment added after publishing (not on Stories). maxLength: 2200 minLength: 1 type: string isAiGenerated: description: >- Label the post as containing AI-generated media. type: boolean shareToFeed: description: >- Reels only: also show the Reel on the main feed (default true). type: boolean type: object - if: properties: platform: enum: - twitter - x required: - platform then: properties: platformSpecificData: anyOf: - type: 'null' - additionalProperties: false description: '' properties: madeWithAi: description: >- Label the post as containing AI-generated media. type: boolean poll: additionalProperties: false description: >- A poll; cannot be combined with media or threadItems. properties: duration_minutes: maximum: 10080 minimum: 5 type: integer options: items: maxLength: 25 minLength: 1 type: string maxItems: 4 minItems: 2 type: array required: - options - duration_minutes type: object replySettings: description: Who can reply. enum: - following - mentionedUsers - subscribers - verified type: string threadItems: description: >- The whole thread; the first item is the root post. Cannot be combined with poll. items: additionalProperties: false properties: content: description: Text of this post. maxLength: 25000 minLength: 1 type: string required: - content type: object minItems: 1 type: array type: object - if: properties: platform: enum: - youtube required: - platform then: properties: platformSpecificData: anyOf: - type: 'null' - additionalProperties: false description: >- Required to schedule or publish: madeForKids. properties: containsSyntheticMedia: description: >- Label the video as containing synthetic (AI-generated) content. type: boolean firstComment: description: First comment posted after upload. maxLength: 10000 minLength: 1 type: string madeForKids: description: >- COPPA: whether the video is made for kids. Required, and must be the user's explicit choice. type: boolean title: description: Video title. maxLength: 100 minLength: 1 type: string visibility: description: Video visibility. enum: - public - private - unlisted type: string type: object - if: properties: platform: enum: - facebook required: - platform then: properties: platformSpecificData: anyOf: - type: 'null' - additionalProperties: false description: '' properties: contentType: description: story or reel; omitted is a feed post. enum: - story - reel type: string firstComment: description: >- First comment added after publishing (not on stories). maxLength: 8000 minLength: 1 type: string pageId: description: >- Page to post to when the account manages several. maxLength: 64 minLength: 1 type: string type: object - if: properties: platform: enum: - linkedin required: - platform then: properties: platformSpecificData: anyOf: - type: 'null' - additionalProperties: false description: >- linkedin accepts no platformSpecificData yet. properties: {} type: object - if: properties: platform: enum: - pinterest required: - platform then: properties: platformSpecificData: anyOf: - type: 'null' - additionalProperties: false description: '' properties: isAiGenerated: description: Label the Pin as AI modified. type: boolean type: object - if: properties: platform: enum: - threads required: - platform then: properties: platformSpecificData: anyOf: - type: 'null' - additionalProperties: false description: threads accepts no platformSpecificData yet. properties: {} type: object - if: properties: platform: enum: - reddit required: - platform then: properties: platformSpecificData: anyOf: - type: 'null' - additionalProperties: false description: reddit accepts no platformSpecificData yet. properties: {} type: object properties: accountId: pattern: ^acc_[0-9A-Za-z]{22}$ type: - string - 'null' customContent: type: - string - 'null' customMedia: items: additionalProperties: false properties: altText: type: - string - 'null' mediaId: pattern: ^med_[0-9A-Za-z]{22}$ type: - string - 'null' thumbnailUrl: type: - string - 'null' title: type: - string - 'null' type: type: - string - 'null' url: type: - string - 'null' type: - object - 'null' type: - array - 'null' platform: enum: - tiktok - instagram - twitter - youtube - facebook - linkedin - pinterest - threads - reddit - x - null type: - string - 'null' platformSpecificData: additionalProperties: {} description: >- Platform options, checked against the platform registry: unknown fields are rejected with unknown_field. The accepted fields depend on platform; fields required to schedule or publish are named in each description. type: - object - 'null' scheduledFor: format: date-time type: - string - 'null' type: - object - 'null' type: - array - 'null' profileId: pattern: ^prf_[0-9A-Za-z]{22}$ type: - string - 'null' publishNow: type: - boolean - 'null' scheduledFor: format: date-time type: - string - 'null' timezone: type: - string - 'null' title: type: - string - 'null' type: object required: true responses: '200': content: application/json: schema: properties: content: type: - string - 'null' createdAt: format: date-time type: - string - 'null' id: type: - string - 'null' mediaItems: items: properties: altText: type: - string - 'null' mediaId: pattern: ^med_[0-9A-Za-z]{22}$ type: - string - 'null' thumbnailUrl: type: - string - 'null' title: type: - string - 'null' type: type: - string - 'null' url: type: - string - 'null' type: - object - 'null' type: - array - 'null' notice: type: - string - 'null' platforms: items: properties: accountId: pattern: ^acc_[0-9A-Za-z]{22}$ type: - string - 'null' customContent: type: - string - 'null' customMedia: items: properties: altText: type: - string - 'null' mediaId: pattern: ^med_[0-9A-Za-z]{22}$ type: - string - 'null' thumbnailUrl: type: - string - 'null' title: type: - string - 'null' type: type: - string - 'null' url: type: - string - 'null' type: - object - 'null' type: - array - 'null' error: properties: category: enum: - platform_rate_limit - platform_error - system_error - unknown - auth_expired - account_issue - user_content - user_abuse - platform_rejected - quota_exhausted - null type: - string - 'null' message: type: - string - 'null' platformError: additionalProperties: {} type: - object - 'null' retryHint: enum: - never - after_delay - after_reconnect - reconcile_first - null type: - string - 'null' retryable: type: - boolean - 'null' source: type: - string - 'null' type: - object - 'null' platform: enum: - tiktok - instagram - twitter - youtube - facebook - linkedin - pinterest - threads - reddit - googlebusiness - googleanalytics - bluesky - telegram - slack - snapchat - hubspot - microsoft - null type: - string - 'null' platformPostId: type: - string - 'null' platformPostUrl: type: - string - 'null' platformSpecificData: additionalProperties: {} type: - object - 'null' publishedAt: format: date-time type: - string - 'null' removedAt: format: date-time type: - string - 'null' scheduledFor: format: date-time type: - string - 'null' status: type: - string - 'null' type: - object - 'null' type: - array - 'null' profileId: pattern: ^prf_[0-9A-Za-z]{22}$ type: - string - 'null' scheduledFor: format: date-time type: - string - 'null' status: type: - string - 'null' timezone: type: - string - 'null' title: type: - string - 'null' updatedAt: format: date-time type: - string - 'null' type: object description: Success '201': content: application/json: schema: properties: content: type: - string - 'null' createdAt: format: date-time type: - string - 'null' id: type: - string - 'null' mediaItems: items: properties: altText: type: - string - 'null' mediaId: pattern: ^med_[0-9A-Za-z]{22}$ type: - string - 'null' thumbnailUrl: type: - string - 'null' title: type: - string - 'null' type: type: - string - 'null' url: type: - string - 'null' type: - object - 'null' type: - array - 'null' notice: type: - string - 'null' platforms: items: properties: accountId: pattern: ^acc_[0-9A-Za-z]{22}$ type: - string - 'null' customContent: type: - string - 'null' customMedia: items: properties: altText: type: - string - 'null' mediaId: pattern: ^med_[0-9A-Za-z]{22}$ type: - string - 'null' thumbnailUrl: type: - string - 'null' title: type: - string - 'null' type: type: - string - 'null' url: type: - string - 'null' type: - object - 'null' type: - array - 'null' error: properties: category: enum: - platform_rate_limit - platform_error - system_error - unknown - auth_expired - account_issue - user_content - user_abuse - platform_rejected - quota_exhausted - null type: - string - 'null' message: type: - string - 'null' platformError: additionalProperties: {} type: - object - 'null' retryHint: enum: - never - after_delay - after_reconnect - reconcile_first - null type: - string - 'null' retryable: type: - boolean - 'null' source: type: - string - 'null' type: - object - 'null' platform: enum: - tiktok - instagram - twitter - youtube - facebook - linkedin - pinterest - threads - reddit - googlebusiness - googleanalytics - bluesky - telegram - slack - snapchat - hubspot - microsoft - null type: - string - 'null' platformPostId: type: - string - 'null' platformPostUrl: type: - string - 'null' platformSpecificData: additionalProperties: {} type: - object - 'null' publishedAt: format: date-time type: - string - 'null' removedAt: format: date-time type: - string - 'null' scheduledFor: format: date-time type: - string - 'null' status: type: - string - 'null' type: - object - 'null' type: - array - 'null' profileId: pattern: ^prf_[0-9A-Za-z]{22}$ type: - string - 'null' scheduledFor: format: date-time type: - string - 'null' status: type: - string - 'null' timezone: type: - string - 'null' title: type: - string - 'null' updatedAt: format: date-time type: - string - 'null' type: object description: Success '202': content: application/json: schema: properties: content: type: - string - 'null' createdAt: format: date-time type: - string - 'null' id: type: - string - 'null' mediaItems: items: properties: altText: type: - string - 'null' mediaId: pattern: ^med_[0-9A-Za-z]{22}$ type: - string - 'null' thumbnailUrl: type: - string - 'null' title: type: - string - 'null' type: type: - string - 'null' url: type: - string - 'null' type: - object - 'null' type: - array - 'null' notice: type: - string - 'null' platforms: items: properties: accountId: pattern: ^acc_[0-9A-Za-z]{22}$ type: - string - 'null' customContent: type: - string - 'null' customMedia: items: properties: altText: type: - string - 'null' mediaId: pattern: ^med_[0-9A-Za-z]{22}$ type: - string - 'null' thumbnailUrl: type: - string - 'null' title: type: - string - 'null' type: type: - string - 'null' url: type: - string - 'null' type: - object - 'null' type: - array - 'null' error: properties: category: enum: - platform_rate_limit - platform_error - system_error - unknown - auth_expired - account_issue - user_content - user_abuse - platform_rejected - quota_exhausted - null type: - string - 'null' message: type: - string - 'null' platformError: additionalProperties: {} type: - object - 'null' retryHint: enum: - never - after_delay - after_reconnect - reconcile_first - null type: - string - 'null' retryable: type: - boolean - 'null' source: type: - string - 'null' type: - object - 'null' platform: enum: - tiktok - instagram - twitter - youtube - facebook - linkedin - pinterest - threads - reddit - googlebusiness - googleanalytics - bluesky - telegram - slack - snapchat - hubspot - microsoft - null type: - string - 'null' platformPostId: type: - string - 'null' platformPostUrl: type: - string - 'null' platformSpecificData: additionalProperties: {} type: - object - 'null' publishedAt: format: date-time type: - string - 'null' removedAt: format: date-time type: - string - 'null' scheduledFor: format: date-time type: - string - 'null' status: type: - string - 'null' type: - object - 'null' type: - array - 'null' profileId: pattern: ^prf_[0-9A-Za-z]{22}$ type: - string - 'null' scheduledFor: format: date-time type: - string - 'null' status: type: - string - 'null' timezone: type: - string - 'null' title: type: - string - 'null' updatedAt: format: date-time type: - string - 'null' type: object description: Accepted; the outcome is pending and arrives by webhook '207': content: application/json: schema: properties: content: type: - string - 'null' createdAt: format: date-time type: - string - 'null' id: type: - string - 'null' mediaItems: items: properties: altText: type: - string - 'null' mediaId: pattern: ^med_[0-9A-Za-z]{22}$ type: - string - 'null' thumbnailUrl: type: - string - 'null' title: type: - string - 'null' type: type: - string - 'null' url: type: - string - 'null' type: - object - 'null' type: - array - 'null' notice: type: - string - 'null' platforms: items: properties: accountId: pattern: ^acc_[0-9A-Za-z]{22}$ type: - string - 'null' customContent: type: - string - 'null' customMedia: items: properties: altText: type: - string - 'null' mediaId: pattern: ^med_[0-9A-Za-z]{22}$ type: - string - 'null' thumbnailUrl: type: - string - 'null' title: type: - string - 'null' type: type: - string - 'null' url: type: - string - 'null' type: - object - 'null' type: - array - 'null' error: properties: category: enum: - platform_rate_limit - platform_error - system_error - unknown - auth_expired - account_issue - user_content - user_abuse - platform_rejected - quota_exhausted - null type: - string - 'null' message: type: - string - 'null' platformError: additionalProperties: {} type: - object - 'null' retryHint: enum: - never - after_delay - after_reconnect - reconcile_first - null type: - string - 'null' retryable: type: - boolean - 'null' source: type: - string - 'null' type: - object - 'null' platform: enum: - tiktok - instagram - twitter - youtube - facebook - linkedin - pinterest - threads - reddit - googlebusiness - googleanalytics - bluesky - telegram - slack - snapchat - hubspot - microsoft - null type: - string - 'null' platformPostId: type: - string - 'null' platformPostUrl: type: - string - 'null' platformSpecificData: additionalProperties: {} type: - object - 'null' publishedAt: format: date-time type: - string - 'null' removedAt: format: date-time type: - string - 'null' scheduledFor: format: date-time type: - string - 'null' status: type: - string - 'null' type: - object - 'null' type: - array - 'null' profileId: pattern: ^prf_[0-9A-Za-z]{22}$ type: - string - 'null' scheduledFor: format: date-time type: - string - 'null' status: type: - string - 'null' timezone: type: - string - 'null' title: type: - string - 'null' updatedAt: format: date-time type: - string - 'null' type: object description: Some platforms failed; see each platform's status and error default: content: application/json: schema: properties: error: properties: code: type: - string - 'null' details: additionalProperties: {} type: - object - 'null' message: type: - string - 'null' param: type: - string - 'null' retryHint: enum: - never - after_delay - after_reconnect - reconcile_first - null type: - string - 'null' retryable: type: - boolean - 'null' type: type: - string - 'null' type: - object - 'null' type: object description: Error. The code field is stable; see the error catalog. x-codeSamples: - lang: text label: Reference example source: >- # Fixed reference example. Playground inputs do not update this sample. curl --request POST \ --url https://api.aisa.one/apis/v1/social/posts \ --header 'Authorization: Bearer ' \ --header 'Content-Type: application/json' \ --data '{ "content": "Our spring collection is live.", "mediaItems": [ { "mediaId": "med_5Tc8Hn2Wq7Lx3Bv9Kd4Fr6", "type": "video" } ], "platforms": [ { "accountId": "acc_7Hq2Lm9Xc4Rt8Vw1Nb6Ks3", "platform": "tiktok", "platformSpecificData": { "privacyLevel": "PUBLIC_TO_EVERYONE" } } ], "profileId": "prf_2Bn8Wq5Td1Yh7Kc3Mz9Lp4", "scheduledFor": "2026-11-20T15:00:00Z", "timezone": "America/New_York" }' components: securitySchemes: bearerAuth: scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.