How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Postiz Posts API

Create, schedule, list, and delete posts.

Postiz Posts API is one of 30 APIs that Postiz publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Posts. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 28 operations across 23 paths, and defines 39 schemas. It is described by OpenAPI 3.2.0, at version 1.0.

Requests are made against 2 base URLs: https://api.postiz.com/public/v1, https://{your-domain}/api/public/v1.

28 operations 23 paths 39 schemas 4 DELETE11 GET8 POST5 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0
Base URL
https://api.postiz.com/public/v1
Authentication
API Key
Resource Areas
1

Authentication & Security 1

Postiz Posts API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (ApiKeyAuth).

  • ApiKeyAuth — Your Postiz API key, sent as the raw value of the Authorization header.

Paths & Operations 28

Across 23 paths, the API surfaces 28 operations — 4 DELETE, 11 GET, 8 POST, 5 PUT. Each is listed below with its method, path, parameters, and response codes.

Posts 28
GET
/posts/{id}/statistics
PostsController_getStatistics 1 param → 200
GET
/posts/{id}/missing
PostsController_getMissingContent 1 param → 200
PUT
/posts/{id}/release-id
PostsController_updateReleaseId 1 param → 200
POST
/posts/should-shortlink
PostsController_shouldShortlink → 201
POST
/posts/{id}/comments
PostsController_createComment 1 param → 201
GET
/posts/tags
PostsController_getTags → 200
POST
/posts/tags
PostsController_createTag body → 201
PUT
/posts/tags/{id}
PostsController_editTag 1 param body → 200
DELETE
/posts/tags/{id}
PostsController_deleteTag 1 param → 200
GET
/posts
PostsController_getPosts → 200
POST
/posts
PostsController_createPost → 201
GET
/posts/find-slot
PostsController_findSlot → 200
GET
/posts/find-slot/{id}
PostsController_findSlotIntegration 1 param → 200
GET
/posts/list
PostsController_getPostsList → 200
GET
/posts/old
PostsController_oldPosts 1 param → 200
GET
/posts/group/{group}/debug-export
PostsController_getPostGroupDebugExport 1 param → 200
GET
/posts/group/{group}
PostsController_getPostsByGroup 1 param → 200
DELETE
/posts/group/{group}
Delete posts by group
deletePostByGroup 1 param → 200
GET
/posts/{id}
PostsController_getPost 1 param → 200
DELETE
/posts/{id}
Delete a post
deletePost 1 param → 200
POST
/posts/valid
PostsController_validatePosts → 201
POST
/posts/generator/draft
PostsController_generatePostsDraft body → 201
POST
/posts/generator
PostsController_generatePosts body → 201
DELETE
/posts/{group}
PostsController_deletePost 1 param → 200
PUT
/posts/{id}/date
PostsController_changeDate 1 param → 200
POST
/posts/separate-posts
PostsController_separatePosts → 201
PUT
/posts/{id}/status
Change post status
changePostStatus 1 param body → 200
PUT
/posts/{id}/settings
Update post settings
updatePostSettings 1 param body → 200400404

Schemas 39

The contract defines 39 schemas that model the data the API accepts and returns. The most detailed are GmbSettings (12 properties), TikTokSettings (11 properties), CreatePostRequest_2 (7 properties), HashnodeSettings (7 properties). Each schema is shown below with its type and property counts.

CreateTagDto
object
CreateGeneratedPostsDto
object
GeneratorDto
object
Tag
object
2 properties 2 required
CreatePostRequest
object
7 properties 4 required
PostItem
object
4 properties 2 required
PostsResponse
object
1 property
PostContent
object
3 properties 1 required
Media
object
2 properties 2 required
Post
object
6 properties
MissingContentItem
object
2 properties
DevToSettings
object
6 properties 2 required
MediumSettings
object
6 properties 3 required
PostContent_2
object
3 properties 1 required
WhopSettings
object
Whop post settings
4 properties 3 required
EmptySettings
object
For platforms that don't require additional settings
1 property 1 required
DiscordSettings
object
2 properties 2 required
RedditSettings
object
2 properties 2 required
TwitchSettings
object
Twitch post settings
3 properties 1 required
YouTubeSettings
object
6 properties 3 required
MoltbookSettings
object
Moltbook post settings
2 properties 2 required
InstagramSettings
object
5 properties 2 required
CreatePostRequest_2
object
7 properties 4 required
GmbSettings
object
Google My Business post settings
12 properties 1 required
SkoolSettings
object
Skool post settings
4 properties 4 required
WarpcastSettings
object
Warpcast (Farcaster) post settings
2 properties 1 required
ListmonkSettings
object
5 properties 4 required
Post_2
object
7 properties
FacebookSettings
object
Facebook post settings
2 properties 1 required
PostItem_2
object
4 properties 2 required
LinkedInSettings
object
3 properties 1 required
HashnodeSettings
object
7 properties 3 required
DribbbleSettings
object
3 properties 2 required
PinterestSettings
object
5 properties 2 required
SlackSettings
object
2 properties 2 required
XSettings
object
3 properties 2 required
LemmySettings
object
Lemmy uses 'subreddit' for communities (historical naming)
2 properties 2 required
TikTokSettings
object
11 properties 9 required
WordpressSettings
object
4 properties 3 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

postiz-posts-api-openapi.yml Raw ↑

Other APIs Postiz publishes across the network.

Postiz Webhooks
Postiz Analytics API
Postiz Integrations API
Postiz Notifications API
Postiz Uploads API
Postiz MCP Server
Postiz Admin API
Postiz Announcements API
Postiz Approved Apps API
Postiz Auth API
Postiz Autopost API
Postiz Billing API
Where this information came from

This is an independent, third-party profile of Postiz Posts API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.