Resources

OpenAPI spec

A machine-readable description of the entire API, in OpenAPI 3.0. It's generated from the same endpoint definitions that render these docs, so the two can never drift apart.

openapi.json

The spec lives at https://postmyish.com/api/v1/openapi.json and is served with a one-hour cache. Fetch it programmatically any time:

curl https://postmyish.com/api/v1/openapi.json

What you can do with it

Import to Postman

Load the URL as an API definition to get a ready-made request collection.

Generate a client

Feed it to openapi-generator or similar to scaffold a typed SDK in your language.

Power tools & agents

A structured contract is the groundwork for the SDKs and MCP server on our roadmap.

Always in sync

Every endpoint, parameter, and response shape in the spec is derived from the live definitions — when the reference pages change, the spec changes with them in the same build.

Endpoints covered

All seven endpoints, tagged by resource (Posts, Accounts, Analytics, Account):

GET/me

Verify an API key and read the account, plan, limits, and usage.

POST/posts

Publish now, or schedule with schedule_at, across every selected network.

GET/posts

List your posts with per-network delivery status. Filter by status.

GET/posts/{id}

Fetch a single post with its status and metrics.

DELETE/posts/{id}

Cancel a scheduled post or remove a draft before it ships.

GET/accounts

List connected profiles and the handles you publish as.

GET/analytics

Pull reach, engagement, and follower totals per network.