> ## Documentation Index > Fetch the complete documentation index at: https://kavenio.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # List posts > Returns posts for the authenticated organization, optionally filtered by profile, account, platform, status, search text, or date range. ## OpenAPI ````yaml /api/openapi.json get /v1/posts openapi: 3.1.0 info: title: Kavenio API version: 1.0.0 license: name: Proprietary url: https://kavenio.com/terms description: Generated OpenAPI document for the stable Kavenio public API. servers: - url: https://api.kavenio.com security: - bearerAuth: [] tags: - name: API keys description: Manage Kavenio API keys for the authenticated user. - name: Integrations description: Connect automation clients and manage workflow subscriptions. - name: Feature requests description: Submit feature requests from authenticated users. - name: Posts description: Create, schedule, update, and manage post lifecycle actions. - name: Queue description: Manage reusable post queue schedules and preview slots. - name: Media description: Upload, presign, and validate media assets. - name: Validation description: Validate post payloads and platform content length limits. - name: Connect description: Start and complete account connection flows. - name: Accounts description: Manage connected social accounts and account health. - name: Telegram description: Manage Telegram-specific connected account settings. - name: Discord description: Manage Discord messages, roles, pins, events, and settings. - name: Google Business description: Manage Google Business locations, reviews, and helpers. - name: Ads description: Create, read, cancel, and inspect advertising resources. - name: Ad audiences description: Manage advertising audiences and audience members. - name: Ad catalogs description: Inspect advertising catalogs and product sets. - name: Ad targeting description: Search targeting entities and estimate audience reach. - name: Ad conversions description: Manage conversion destinations and send conversion events. - name: Ad leads description: Manage lead forms and retrieve advertising leads. - name: Tracking tags description: Manage Meta tracking tags and tag sharing. - name: Platform credentials description: Manage organization platform app credentials. - name: Analytics description: Read provider analytics and operational inbox data. - name: WhatsApp conversions description: Read and send WhatsApp conversion events. - name: Activity description: Read operational activity events. - name: Webhooks description: Manage webhook endpoints and delivery logs. paths: /v1/posts: get: tags: - Posts summary: List posts description: >- Returns posts for the authenticated organization, optionally filtered by profile, account, platform, status, search text, or date range. operationId: listPosts parameters: - in: query name: profileId schema: type: string minLength: 1 maxLength: 255 - in: query name: accountId schema: type: string minLength: 16 maxLength: 16 pattern: ^[abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ]{16}$ - in: query name: platform schema: type: string enum: - twitter - pinterest - linkedin - bluesky - mastodon - reddit - telegram - youtube - facebook - instagram - threads - tiktok - googlebusiness - discord - in: query name: status schema: type: string enum: - draft - scheduled - publishing - published - unpublished - action_required - failed - partial - cancelled - in: query name: search schema: type: string minLength: 1 - in: query name: fromDate schema: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ - in: query name: toDate schema: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ - in: query name: page schema: type: integer minimum: 1 maximum: 9007199254740991 - in: query name: limit schema: type: integer minimum: 1 maximum: 100 responses: '200': description: Posts returned. content: application/json: schema: anyOf: - type: object properties: ok: type: boolean x-kavenio-const: true data: type: object properties: posts: type: array items: type: object properties: id: type: string minLength: 16 maxLength: 16 pattern: >- ^[abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ]{16}$ organizationId: type: string minLength: 1 profileId: type: string minLength: 1 maxLength: 255 createdBy: type: string minLength: 1 title: type: string content: type: string status: type: string enum: - draft - scheduled - publishing - published - unpublished - action_required - failed - partial - cancelled scheduledFor: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ publishedAt: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ timezone: type: string mediaItems: type: array items: type: object properties: type: type: string enum: - image - video - gif - audio - document url: type: string format: uri title: type: string minLength: 1 altText: type: string minLength: 1 filename: type: string minLength: 1 size: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 mimeType: type: string minLength: 1 thumbnail: type: string format: uri durationMs: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 durationSeconds: type: number exclusiveMinimum: 0 width: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 height: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 frameRate: type: number exclusiveMinimum: 0 frameCount: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 required: - type - url additionalProperties: false tags: type: array items: type: string hashtags: type: array items: type: string mentions: type: array items: type: string metadata: type: object propertyNames: type: string additionalProperties: {} crosspostingEnabled: type: boolean queuedFromProfile: type: string minLength: 1 maxLength: 255 queueId: type: string minLength: 16 maxLength: 16 pattern: >- ^[abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ]{16}$ recycling: type: object properties: enabled: type: boolean interval: type: string enum: - daily - weekly - monthly frequency: type: string enum: - daily - weekly - monthly every: type: integer exclusiveMinimum: 0 maximum: 365 maxOccurrences: type: integer exclusiveMinimum: 0 maximum: 1000 endsAt: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ expiresAt: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ until: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ endDate: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ preserveQueue: type: boolean allowDuplicateForRecycling: type: boolean additionalProperties: {} targets: type: array items: type: object properties: id: type: string minLength: 16 maxLength: 16 pattern: >- ^[abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ]{16}$ postId: type: string minLength: 16 maxLength: 16 pattern: >- ^[abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ]{16}$ platform: type: string enum: - twitter - pinterest - linkedin - bluesky - mastodon - reddit - telegram - youtube - facebook - instagram - threads - tiktok - googlebusiness - discord accountId: type: string minLength: 16 maxLength: 16 pattern: >- ^[abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ]{16}$ status: type: string enum: - draft - scheduled - publishing - published - unpublished - action_required - failed - partial - cancelled customContent: type: string customMedia: type: array items: type: object properties: type: type: string enum: - image - video - gif - audio - document url: type: string format: uri title: type: string minLength: 1 altText: type: string minLength: 1 filename: type: string minLength: 1 size: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 mimeType: type: string minLength: 1 thumbnail: type: string format: uri durationMs: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 durationSeconds: type: number exclusiveMinimum: 0 width: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 height: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 frameRate: type: number exclusiveMinimum: 0 frameCount: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 required: - type - url additionalProperties: false scheduledFor: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ platformSpecificData: anyOf: - type: object properties: replyToTweetId: type: string minLength: 1 quoteTweetId: type: string minLength: 1 mediaIds: minItems: 1 maxItems: 4 type: array items: type: string minLength: 1 replySettings: type: string enum: - following - mentionedUsers - subscribers - verified threadItems: minItems: 1 type: array items: type: object properties: content: type: string mediaItems: type: array items: type: object properties: type: type: string enum: - image - video - gif - audio - document url: type: string format: uri title: type: string minLength: 1 altText: type: string minLength: 1 filename: type: string minLength: 1 size: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 mimeType: type: string minLength: 1 thumbnail: type: string format: uri durationMs: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 durationSeconds: type: number exclusiveMinimum: 0 width: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 height: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 frameRate: type: number exclusiveMinimum: 0 frameCount: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 required: - type - url additionalProperties: false additionalProperties: false poll: type: object properties: options: minItems: 2 maxItems: 4 type: array items: type: string minLength: 1 maxLength: 25 duration_minutes: type: integer minimum: 5 maximum: 10080 required: - options - duration_minutes additionalProperties: false longVideo: type: boolean paidPartnership: type: boolean madeWithAi: type: boolean firstComment: type: string minLength: 1 sensitiveMedia: type: object properties: adultContent: type: boolean graphicViolence: type: boolean other: type: boolean additionalProperties: false additionalProperties: false - type: object properties: title: type: string maxLength: 100 boardId: type: string pattern: ^\d+$ boardSectionId: type: string pattern: ^\d+$ mediaId: type: string pattern: ^\d+$ link: type: string maxLength: 2048 format: uri coverImageUrl: type: string maxLength: 2048 format: uri coverImageKeyFrameTime: type: integer minimum: 0 maximum: 9007199254740991 altText: type: string minLength: 1 maxLength: 500 aiDisclosures: type: object properties: values: minItems: 1 maxItems: 2 type: array items: type: string enum: - SYNTHETIC_PERFORMER - AI_MODIFIED required: - values additionalProperties: false additionalProperties: false - type: object properties: documentTitle: type: string minLength: 1 organizationUrn: type: string minLength: 1 mediaUrns: minItems: 1 maxItems: 20 type: array items: type: string minLength: 1 firstComment: type: string minLength: 1 visibility: type: string enum: - public - connections disableLinkPreview: type: boolean reshareUrl: type: string minLength: 1 geoRestriction: {} additionalProperties: false - type: object properties: threadItems: minItems: 1 type: array items: type: object properties: content: type: string mediaItems: type: array items: type: object properties: type: type: string enum: - image - video - gif - audio - document url: type: string format: uri title: type: string minLength: 1 altText: type: string minLength: 1 filename: type: string minLength: 1 size: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 mimeType: type: string minLength: 1 thumbnail: type: string format: uri durationMs: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 durationSeconds: type: number exclusiveMinimum: 0 width: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 height: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 frameRate: type: number exclusiveMinimum: 0 frameCount: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 required: - type - url additionalProperties: false additionalProperties: false externalUrl: type: string format: uri externalTitle: type: string minLength: 1 maxLength: 300 externalDescription: type: string maxLength: 1000 externalThumbUrl: type: string format: uri disableLinkPreview: type: boolean additionalProperties: false - type: object properties: visibility: type: string enum: - public - unlisted - private - direct sensitive: type: boolean spoilerText: type: string minLength: 1 maxLength: 500 language: type: string pattern: ^[a-z]{2}$ inReplyToStatusId: type: string minLength: 1 quotedStatusId: type: string minLength: 1 quoteApprovalPolicy: type: string enum: - public - followers - nobody poll: type: object properties: options: minItems: 2 type: array items: type: string minLength: 1 expiresInSeconds: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 multiple: type: boolean hideTotals: type: boolean required: - options - expiresInSeconds additionalProperties: false additionalProperties: false - type: object properties: subreddit: type: string minLength: 1 title: type: string maxLength: 300 url: type: string format: uri forceSelf: type: boolean flairId: type: string minLength: 1 flairText: type: string minLength: 1 nsfw: type: boolean spoiler: type: boolean sendreplies: type: boolean nativeVideo: type: boolean videogif: type: boolean videoPosterUrl: type: string format: uri additionalProperties: false - type: object properties: contentType: type: string enum: - message - story chatId: type: string minLength: 1 parseMode: type: string enum: - HTML - Markdown - MarkdownV2 disableWebPagePreview: type: boolean disableNotification: type: boolean protectContent: type: boolean messageThreadId: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 sendAsDocument: type: boolean activePeriodSeconds: anyOf: - type: number const: 21600 - type: number const: 43200 - type: number const: 86400 - type: number const: 172800 postToChatPage: type: boolean additionalProperties: false - type: object properties: channelId: type: string pattern: ^\d{1,20}$ embeds: maxItems: 10 type: array items: type: object properties: title: type: string minLength: 1 maxLength: 256 description: type: string minLength: 1 maxLength: 4096 url: type: string format: uri timestamp: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$ color: type: integer minimum: 0 maximum: 16777215 footer: type: object properties: text: type: string minLength: 1 maxLength: 2048 iconUrl: type: string format: uri required: - text additionalProperties: false image: type: object properties: url: type: string format: uri required: - url additionalProperties: false thumbnail: type: object properties: url: type: string format: uri required: - url additionalProperties: false author: type: object properties: name: type: string minLength: 1 maxLength: 256 url: type: string format: uri iconUrl: type: string format: uri required: - name additionalProperties: false fields: maxItems: 25 type: array items: type: object properties: name: type: string minLength: 1 maxLength: 256 value: type: string minLength: 1 maxLength: 1024 inline: type: boolean required: - name - value additionalProperties: false additionalProperties: false poll: type: object properties: question: type: string minLength: 1 maxLength: 300 answers: minItems: 2 maxItems: 10 type: array items: type: object properties: text: type: string minLength: 1 maxLength: 55 emojiId: type: string pattern: ^\d{1,20}$ emojiName: type: string minLength: 1 maxLength: 32 required: - text additionalProperties: false durationHours: default: 24 type: integer minimum: 1 maximum: 768 allowMultiselect: type: boolean required: - question - answers - durationHours additionalProperties: false crosspost: type: boolean forumThreadName: type: string minLength: 1 maxLength: 100 forumAppliedTags: maxItems: 5 type: array items: type: string pattern: ^\d{1,20}$ threadFromMessage: type: object properties: name: type: string minLength: 1 maxLength: 100 autoArchiveDuration: anyOf: - type: number const: 60 - type: number const: 1440 - type: number const: 4320 - type: number const: 10080 rateLimitPerUser: type: integer minimum: 0 maximum: 21600 required: - name additionalProperties: false tts: type: boolean webhookUsername: type: string minLength: 1 maxLength: 80 webhookAvatarUrl: type: string format: uri allowedMentions: type: object properties: parse: maxItems: 3 type: array items: type: string enum: - roles - users - everyone roles: maxItems: 100 type: array items: type: string pattern: ^\d{1,20}$ users: maxItems: 100 type: array items: type: string pattern: ^\d{1,20}$ repliedUser: type: boolean additionalProperties: false additionalProperties: false - type: object properties: pageId: type: string minLength: 1 contentType: type: string enum: - feed - story - reel - video firstComment: type: string minLength: 1 title: type: string minLength: 1 maxLength: 255 reelTitle: type: string minLength: 1 maxLength: 255 link: type: string format: uri carouselLink: type: string format: uri carouselCards: minItems: 2 maxItems: 5 type: array items: type: object properties: link: type: string format: uri name: type: string minLength: 1 maxLength: 255 description: type: string minLength: 1 maxLength: 1000 additionalProperties: false unpublishedContentType: type: string enum: - draft - scheduled draft: type: boolean scheduledPublishTime: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$ geoRestriction: type: object properties: countries: minItems: 1 maxItems: 25 type: array items: type: string pattern: ^[A-Z]{2}$ regions: minItems: 1 type: array items: type: object properties: key: type: string minLength: 1 name: type: string minLength: 1 country: type: string pattern: ^[A-Z]{2}$ required: - key additionalProperties: false cities: minItems: 1 type: array items: type: object properties: key: type: string minLength: 1 name: type: string minLength: 1 country: type: string pattern: ^[A-Z]{2}$ required: - key additionalProperties: false additionalProperties: false geoRestrictions: type: object properties: countries: minItems: 1 maxItems: 25 type: array items: type: string pattern: ^[A-Z]{2}$ regions: minItems: 1 type: array items: type: object properties: key: type: string minLength: 1 name: type: string minLength: 1 country: type: string pattern: ^[A-Z]{2}$ required: - key additionalProperties: false cities: minItems: 1 type: array items: type: object properties: key: type: string minLength: 1 name: type: string minLength: 1 country: type: string pattern: ^[A-Z]{2}$ required: - key additionalProperties: false additionalProperties: false multiPageTargets: type: array items: type: string minLength: 1 additionalProperties: false - type: object properties: instagramAccountId: type: string minLength: 1 contentType: type: string enum: - feed - story - reels shareToFeed: type: boolean collaborators: maxItems: 3 type: array items: type: string minLength: 1 userTags: type: array items: type: object properties: username: type: string minLength: 1 x: type: number minimum: 0 maximum: 1 'y': type: number minimum: 0 maximum: 1 mediaIndex: type: integer minimum: 0 maximum: 9007199254740991 required: - username - x - 'y' additionalProperties: false trialParams: type: object properties: graduationStrategy: type: string enum: - MANUAL - SS_PERFORMANCE required: - graduationStrategy additionalProperties: false thumbOffset: type: integer minimum: 0 maximum: 9007199254740991 instagramThumbnail: type: string format: uri audioName: type: string minLength: 1 firstComment: type: string minLength: 1 additionalProperties: false - type: object properties: topicTag: type: string minLength: 1 maxLength: 50 threadItems: minItems: 1 type: array items: type: object properties: content: type: string mediaItems: type: array items: type: object properties: type: type: string enum: - image - video - gif - audio - document url: type: string format: uri title: type: string minLength: 1 altText: type: string minLength: 1 filename: type: string minLength: 1 size: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 mimeType: type: string minLength: 1 thumbnail: type: string format: uri durationMs: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 durationSeconds: type: number exclusiveMinimum: 0 width: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 height: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 frameRate: type: number exclusiveMinimum: 0 frameCount: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 required: - type - url additionalProperties: false additionalProperties: false additionalProperties: false - type: object properties: privacyLevel: type: string minLength: 1 allowComment: type: boolean allowDuet: type: boolean allowStitch: type: boolean contentPreviewConfirmed: type: boolean x-kavenio-const: true expressConsentGiven: type: boolean x-kavenio-const: true musicUsageConfirmed: type: boolean x-kavenio-const: true videoCoverTimestampMs: type: integer minimum: 0 maximum: 9007199254740991 videoCoverImageUrl: type: string format: uri mediaType: type: string enum: - video - photo title: type: string maxLength: 90 photoCoverIndex: type: integer minimum: 0 maximum: 9007199254740991 description: type: string maxLength: 4000 autoAddMusic: type: boolean videoMadeWithAi: type: boolean draft: type: boolean commercialContentType: type: string minLength: 1 additionalProperties: false - type: object properties: title: type: string minLength: 1 maxLength: 100 visibility: type: string enum: - public - private - unlisted publishAsShort: type: boolean madeForKids: type: boolean containsSyntheticMedia: type: boolean categoryId: type: string minLength: 1 tags: maxItems: 30 type: array items: type: string minLength: 1 maxLength: 500 thumbnailUrl: type: string format: uri playlistId: type: string minLength: 1 notifySubscribers: type: boolean firstComment: type: string maxLength: 10000 additionalProperties: false - type: object properties: locationId: type: string minLength: 1 topicType: type: string enum: - STANDARD - EVENT - OFFER languageCode: type: string minLength: 2 maxLength: 35 callToAction: type: string enum: - BOOK - ORDER - SHOP - LEARN_MORE - SIGN_UP - CALL ctaUrl: type: string format: uri eventTitle: type: string minLength: 1 maxLength: 58 eventSchedule: type: object properties: startDate: type: object properties: year: type: integer minimum: 1 maximum: 9007199254740991 month: type: integer minimum: 1 maximum: 12 day: type: integer minimum: 1 maximum: 31 required: - year - month - day additionalProperties: false startTime: type: object properties: hours: type: integer minimum: 0 maximum: 23 minutes: type: integer minimum: 0 maximum: 59 seconds: type: integer minimum: 0 maximum: 59 nanos: type: integer minimum: 0 maximum: 999999999 additionalProperties: false endDate: type: object properties: year: type: integer minimum: 1 maximum: 9007199254740991 month: type: integer minimum: 1 maximum: 12 day: type: integer minimum: 1 maximum: 31 required: - year - month - day additionalProperties: false endTime: type: object properties: hours: type: integer minimum: 0 maximum: 23 minutes: type: integer minimum: 0 maximum: 59 seconds: type: integer minimum: 0 maximum: 59 nanos: type: integer minimum: 0 maximum: 999999999 additionalProperties: false required: - startDate - endDate additionalProperties: false offer: type: object properties: couponCode: type: string minLength: 1 maxLength: 58 redeemOnlineUrl: type: string format: uri termsConditions: type: string minLength: 1 maxLength: 5000 additionalProperties: false additionalProperties: false platformPostId: type: string nativeUrl: type: string format: uri error: type: string createdAt: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ updatedAt: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ required: - id - postId - platform - status - createdAt - updatedAt additionalProperties: false createdAt: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ updatedAt: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ required: - id - organizationId - createdBy - status - mediaItems - tags - hashtags - mentions - metadata - crosspostingEnabled - targets - createdAt - updatedAt additionalProperties: false pagination: type: object properties: page: type: integer minimum: 1 maximum: 9007199254740991 limit: type: integer minimum: 1 maximum: 9007199254740991 total: type: integer minimum: 0 maximum: 9007199254740991 hasMore: type: boolean required: - page - limit - total - hasMore additionalProperties: false required: - posts - pagination additionalProperties: false required: - ok - data additionalProperties: false - type: object properties: ok: type: boolean x-kavenio-const: false error: type: object properties: code: type: string minLength: 1 message: type: string minLength: 1 details: {} required: - code - message additionalProperties: false required: - ok - error additionalProperties: false '401': description: Authentication failed. content: application/json: schema: type: object properties: ok: type: boolean x-kavenio-const: false error: type: object properties: code: type: string minLength: 1 message: type: string minLength: 1 details: {} required: - code - message additionalProperties: false required: - ok - error additionalProperties: false '422': description: Query parameter validation failed. content: application/json: schema: type: object properties: ok: type: boolean x-kavenio-const: false error: type: object properties: code: type: string minLength: 1 message: type: string minLength: 1 details: {} required: - code - message additionalProperties: false required: - ok - error additionalProperties: false '500': description: Post lookup failed. content: application/json: schema: type: object properties: ok: type: boolean x-kavenio-const: false error: type: object properties: code: type: string minLength: 1 message: type: string minLength: 1 details: {} required: - code - message additionalProperties: false required: - ok - error additionalProperties: false components: securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: Clerk session or OAuth token ````