Update Release ID

Updates the releaseId of a post that currently has its release ID set to "missing". This connects the post to its actual published content on the platform, enabling analytics and statistics tracking.

Typically used after calling the Get Missing Content endpoint to retrieve the list of available content items.

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}/release-id:
    put:
      tags:
        - Posts
      summary: Update release ID
      description: >-
        Updates the `releaseId` of a post that currently has its release ID set
        to `"missing"`. This connects the post to its actual published content
        on the platform, enabling analytics and statistics tracking.


        Typically used after calling the **Get Missing Content** endpoint to
        retrieve the list of available content items.
      operationId: updateReleaseId
      parameters:
        - name: id
          in: path
          required: true
          description: Post ID
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - releaseId
              properties:
                releaseId:
                  type: string
                  description: The platform-specific content ID to connect to this post
            example:
              releaseId: '7321456789012345678'
      responses:
        '200':
          description: Release ID updated successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                  releaseId:
                    type: string
              example:
                id: post-123
                releaseId: '7321456789012345678'
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: Your Sipstory API key