# Postify API reference

One page per /v1 operation, generated from the OpenAPI 3.1 spec — request and response schemas, parameters, and the scope each operation requires.

Concepts first (auth, errors, pagination, idempotency, rate limits): [API documentation](https://usepostify.com/docs/api.md).

## Analytics

- [getAnalytics](https://usepostify.com/docs/api-reference/analytics/getAnalytics.md) — `GET /v1/analytics` — Get workspace analytics

## Channels

- [listChannels](https://usepostify.com/docs/api-reference/channels/listChannels.md) — `GET /v1/channels` — List channels

## Media

- [listMedia](https://usepostify.com/docs/api-reference/media/listMedia.md) — `GET /v1/media` — List media assets
- [createMediaUpload](https://usepostify.com/docs/api-reference/media/createMediaUpload.md) — `POST /v1/media/uploads` — Start a media upload
- [completeMediaUpload](https://usepostify.com/docs/api-reference/media/completeMediaUpload.md) — `POST /v1/media/uploads/{id}/complete` — Complete a media upload

## Posts

- [listPosts](https://usepostify.com/docs/api-reference/posts/listPosts.md) — `GET /v1/posts` — List posts
- [createPost](https://usepostify.com/docs/api-reference/posts/createPost.md) — `POST /v1/posts` — Create a post
- [getPost](https://usepostify.com/docs/api-reference/posts/getPost.md) — `GET /v1/posts/{id}` — Get a post
- [reschedulePost](https://usepostify.com/docs/api-reference/posts/reschedulePost.md) — `PATCH /v1/posts/{id}` — Reschedule a post
- [deletePost](https://usepostify.com/docs/api-reference/posts/deletePost.md) — `DELETE /v1/posts/{id}` — Delete a post
- [publishPost](https://usepostify.com/docs/api-reference/posts/publishPost.md) — `POST /v1/posts/{id}/publish` — Publish a post now

## Usage

- [getUsage](https://usepostify.com/docs/api-reference/usage/getUsage.md) — `GET /v1/usage` — Get plan usage

## Webhooks

- [listWebhookEndpoints](https://usepostify.com/docs/api-reference/webhooks/listWebhookEndpoints.md) — `GET /v1/webhook-endpoints` — List webhook endpoints
- [createWebhookEndpoint](https://usepostify.com/docs/api-reference/webhooks/createWebhookEndpoint.md) — `POST /v1/webhook-endpoints` — Create a webhook endpoint
- [updateWebhookEndpoint](https://usepostify.com/docs/api-reference/webhooks/updateWebhookEndpoint.md) — `PATCH /v1/webhook-endpoints/{id}` — Update a webhook endpoint
- [deleteWebhookEndpoint](https://usepostify.com/docs/api-reference/webhooks/deleteWebhookEndpoint.md) — `DELETE /v1/webhook-endpoints/{id}` — Delete a webhook endpoint
- [testWebhookEndpoint](https://usepostify.com/docs/api-reference/webhooks/testWebhookEndpoint.md) — `POST /v1/webhook-endpoints/{id}/test` — Send a test delivery

- [OpenAPI 3.1 spec](https://app.usepostify.com/v1/openapi.json)
- [Error codes](https://usepostify.com/docs/api/problems.md) · [Webhooks](https://usepostify.com/docs/api/webhooks.md)