All endpoints

Every route in the Bulkit API, on one page.

All routes start with your API address, for example http://localhost:3001/public/v1. Every route needs an API key.

For every field and response, open the interactive reference at /public/v1/docs on your Bulkit API (locally: localhost:3001/public/v1/docs). The raw OpenAPI file is at /public/v1/openapi.json.

✏️ = needs a read and write key.

Posts

MethodRouteWhat it does
GET/postsList posts, newest first. Guide
POST ✏️/postsCreate a draft, scheduled or instant post. Guide
GET/posts/{id}Get one post and the result on each channel.
PUT ✏️/posts/{id}Replace a post that is not published yet. Guide
DELETE ✏️/posts/{id}Delete from Bulkit. Live posts stay live.
POST ✏️/posts/{id}/publishPublish now, or retry the channels that failed.
POST ✏️/posts/{id}/reviseChange the text of a live post.
POST ✏️/posts/{id}/retractDelete the post on the social networks.
GET/posts/{id}/metricsLikes, views and more, over time.
GET/posts/{id}/commentsComments on one channel's copy of a live post. Guide
POST ✏️/posts/{id}/comments/{commentId}/repliesReply to a comment. Counts as one post.

Channels, platforms and tags

MethodRouteWhat it does
GET/channelsYour connected accounts. Use their id in posts.
GET/platformsWhat each platform accepts (characters, media, threads…).
GET/tagsYour workspace labels. Create them in the app.

Media

MethodRouteWhat it does
GET/mediaList your uploaded files.
POST ✏️/mediaUpload a file (multipart/form-data, field file). Guide
DELETE ✏️/media/{id}Delete a file.

Webhooks

MethodRouteWhat it does
GET/webhooksList your endpoints.
POST ✏️/webhooksAdd an endpoint. Returns the signing secret once. Guide
GET/webhooks/{id}Get one endpoint.
PUT ✏️/webhooks/{id}Change an endpoint. Only the fields you send change.
DELETE ✏️/webhooks/{id}Delete an endpoint and its history.
GET/webhooks/{id}/deliveriesEvery delivery attempt and its result.
POST ✏️/webhooks/{id}/roll-secretMake a new signing secret.

Usage and stats

MethodRouteWhat it does
GET/usageWhat you used this billing period, and your plan limits. Guide
GET/statsPublishing numbers per day, channel and tag. Needs from and to.

MCP

MethodRouteWhat it does
POST/mcpMCP server for AI agents. Guide

On this page