Skip to main content

Check Connection

Verify if your API key is valid and connected.

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:
/is-connected:
get:
tags:
- Integrations
summary: Check connection status
description: Verify if your API key is valid and connected.
operationId: isConnected
responses:
'200':
description: Connection status
content:
application/json:
schema:
type: object
properties:
connected:
type: boolean
example:
connected: true
components:
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: Authorization
description: Your Sipstory API key