Public API
Postiv Public API
Connect trusted agents and automations to a Postiv workspace: add knowledge, draft and schedule LinkedIn posts, generate branded visuals, and read cached analytics.
The base URL is https://postiv.ai. Every endpoint lives under /api/public and authenticates with an organization API key: no OAuth dance, no per-user tokens. The same key also powers the hosted MCP server, so anything an endpoint can do, an MCP client can do too.
Your first request
curl https://postiv.ai/api/public/workspace \
-H "Authorization: Bearer pk_postiv_..."Quickstart
- 1Generate an API key in Settings → Integrations.
- 2Call GET /api/public/workspace to confirm the key and see its scopes.
- 3Follow the post workflow to draft and schedule your first post.
Built for agents
Every page here has a Copy page button that copies it as Markdown, ready to paste into a prompt. To give an agent the whole API at once, copy the entire docs from the same menu, or point it straight at llms-full.txt, a single plain-text document containing every page.
Explore the API
Workspace1 endpoint: get workspaceKnowledge2 endpoints: add knowledge, search knowledge basePosts7 endpoints: list posts, create post draft, get post, …Images1 endpoint: edit post imageCarousels & Infographics5 endpoints: create carousel, create infographic, get carousel, …Profiles2 endpoints: list linkedin profiles, get writing styleComment Plugs2 endpoints: get comment plug config, set comment plug configPlans & Pillars4 endpoints: list bob content plans, get bob content plan item, list content pillars, …Inspiration & Templates2 endpoints: search post templates, search inspiration libraryScratchpad7 endpoints: list scratchpad items, create scratchpad item, get scratchpad item, …Analytics5 endpoints: list analytics accounts, get analytics summary, get performance overview, …