OpenAPI Specification
openapi: 3.0.1
info:
title: Postiz Public Analytics Notifications API
description: Public REST API for Postiz, the open-source social media scheduling and management platform. The same API surface is served by Postiz Cloud (https://api.postiz.com/public/v1) and by any self-hosted Postiz instance (https://{your-domain}/api/public/v1). Authenticate by sending your API key in the Authorization header. The API lets you list connected channels (integrations), find scheduling slots, upload media, and create, list, and delete posts across 30+ supported social, video, community, and blogging platforms.
termsOfService: https://postiz.com/terms
contact:
name: Postiz Support
url: https://docs.postiz.com/public-api
license:
name: AGPL-3.0
url: https://github.com/gitroomhq/postiz-app/blob/main/LICENSE
version: '1.0'
servers:
- url: https://api.postiz.com/public/v1
description: Postiz Cloud
- url: https://{your-domain}/api/public/v1
description: Self-hosted
variables:
your-domain:
default: localhost:5000
description: Your Postiz instance domain
security:
- ApiKeyAuth: []
tags:
- name: Notifications
description: Account notifications.
paths:
/notifications:
get:
tags:
- Notifications
summary: List notifications
description: Returns account notifications, paginated.
operationId: listNotifications
parameters:
- name: page
in: query
required: false
description: Zero-based page number.
schema:
type: integer
default: 0
responses:
'200':
description: List of notifications
content:
application/json:
schema:
$ref: '#/components/schemas/NotificationsResponse'
components:
schemas:
NotificationsResponse:
type: object
properties:
notifications:
type: array
items:
$ref: '#/components/schemas/Notification'
Notification:
type: object
properties:
id:
type: string
content:
type: string
link:
type: string
createdAt:
type: string
format: date-time
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: Authorization
description: Your Postiz API key, sent as the raw value of the Authorization header.