# posts

> Compose, schedule and publish posts to Instagram, Facebook Pages and Threads.

Compose, schedule and publish posts to Instagram, Facebook Pages and Threads.

| Method | Path | Operation | Scope | Test mode |
|---|---|---|---|---|
| GET | `/v1/content-calendar` | `posts_calendar`: Calendar feed: posts, offers and ad schedule | `posts:read` | - |
| GET | `/v1/post-queue-slots` | `posts_queue_slots`: Best-time queue slots per channel | `posts:read` | - |
| GET | `/v1/posts` | `posts_list`: List posts (calendar window, status, channel) | `posts:read` | - |
| POST | `/v1/posts` | `posts_create`: Create a draft or scheduled post with per-channel targets | `posts:write` | - |
| POST | `/v1/posts:generate` | `posts_generate`: AI captions and hashtags (S3 `POST /posts:generate`) | `ai:read` | - |
| POST | `/v1/posts:validate` | `posts_validate`: Validate a post against per-channel specs and live quota (S3 `POST /posts:validate`) | `posts:read` | - |
| DELETE | `/v1/posts/{post_id}` | `posts_delete`: Delete a post (published: also on the platform where the API allows) | `posts:write` | - |
| GET | `/v1/posts/{post_id}` | `posts_get`: Get a post with per-target status | `posts:read` | - |
| PATCH | `/v1/posts/{post_id}` | `posts_update`: Edit a draft or scheduled post | `posts:write` | - |
| GET | `/v1/posts/{post_id}/insights` | `posts_insights`: Insights per target (metric abstraction) | `analytics:read` | - |
| POST | `/v1/posts/{post_id}/publish` | `posts_publish`: Publish now | `posts:publish` | - |
| POST | `/v1/posts/{post_id}/schedule` | `posts_schedule`: Schedule or reschedule a post | `posts:publish` | - |
| POST | `/v1/posts/{post_id}/unschedule` | `posts_unschedule`: Back to draft | `posts:write` | - |
| GET | `/v1/posts/limits` | `posts_limits`: Remaining publish quota per channel and plan | `posts:read` | - |

Request and response schemas: the interactive reference at `https://api.wapitick.com/docs`, or `docs/api/openapi.json`.
