Get Missing Content

When a post has been published but the platform did not return a usable post ID (the releaseId is set to "missing"), this endpoint fetches recent content from the provider so you can match and connect the correct one to the post.

The provider must implement the optional missing method. If the provider does not support it, an empty array is returned.

OpenAPI

openapi: 3.1.0
info:
  title: Sipstory Public API
  description: >-
    API for managing social media posts, integrations, and media uploads in
    Sipstory.


    ## Authentication


    All endpoints require an API key passed in the `Authorization` header:


    ```

    Authorization: your-api-key

    ```


    Get your API key from Sipstory Settings.


    ## Rate Limits


    There is a limit of **30 requests per hour**.


    ## Terminology


    The UI uses `channel`, but the API uses `integration`. They refer to the
    same thing.


    ## Supported Platforms (27)


    **Social Platforms:** X (Twitter), LinkedIn, LinkedIn Page, Facebook,
    Instagram, Instagram Standalone, Threads, Bluesky, Mastodon, Warpcast
    (Farcaster), Nostr, VK


    **Video Platforms:** YouTube, TikTok


    **Community Platforms:** Reddit, Lemmy, Discord, Slack, Telegram


    **Design Platforms:** Pinterest, Dribbble


    **Blogging Platforms:** Medium, Dev.to, Hashnode, WordPress


    **Business:** Google My Business (GMB), Listmonk (newsletters)
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.sipstory.tech/public/v1
    description: Sipstory Cloud
  - url: https://{your-domain}/api/public/v1
    description: Self-hosted
    variables:
      your-domain:
        default: localhost:5000
        description: Your Sipstory instance domain
security:
  - ApiKeyAuth: []
tags:
  - name: Integrations
    description: Manage connected social media channels
  - name: Posts
    description: Create, list, and delete posts
  - name: Uploads
    description: Upload media files
  - name: Notifications
    description: View organization notifications
  - name: Analytics
    description: View analytics for integrations and posts
  - name: Video Generation
    description: Generate videos with AI
paths:
  /posts/{id}/missing:
    get:
      tags:
        - Posts
      summary: Get missing content
      description: >-
        When a post has been published but the platform did not return a usable
        post ID (the `releaseId` is set to `"missing"`), this endpoint fetches
        recent content from the provider so you can match and connect the
        correct one to the post.


        The provider must implement the optional `missing` method. If the
        provider does not support it, an empty array is returned.
      operationId: getMissingContent
      parameters:
        - name: id
          in: path
          required: true
          description: Post ID
          schema:
            type: string
      responses:
        '200':
          description: List of recent content items from the provider
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/MissingContentItem'
              example:
                - id: '7321456789012345678'
                  url: https://p16-sign.tiktokcdn-us.com/obj/cover-image.jpeg
                - id: '7321456789012345679'
                  url: https://p16-sign.tiktokcdn-us.com/obj/cover-image2.jpeg
components:
  schemas:
    MissingContentItem:
      type: object
      properties:
        id:
          type: string
          description: Platform-specific content ID
        url:
          type: string
          description: Thumbnail or preview URL for the content
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: Your Sipstory API key