# Posttar API

Automate your own Posttar account: create and edit content, schedule, publish, run autopilot and read reports, without opening the app.

The Posttar API gives a script, or another system, the same reach the app has over your account. You can create a post from a theme, edit its slides, set media, schedule it, publish it, turn autopilot on, and read how it performed.

It is available on the **Plus** and **Scale** plans. Calls spend the credits your plan already includes, with no separate billing.

## Base URL

```text
https://api.posttar.com/v1
```

That host serves the API and nothing else: any other path on it answers `404` in the same JSON error shape, never HTML. The same endpoints also answer at `https://app.posttar.com/api/v1`, which is the internal name of the same route.

## What you can do

| Area | What the API covers |
| --- | --- |
| Posts | Create in any of the six formats, read, edit, set media, archive, delete |
| Slides | Read, add, edit, reorder, remove, swap layout, reimagine the image |
| Scheduling | Schedule, unschedule, publish now |
| Reel media | List and pick the background clip and the music track |
| Autopilot | Turn on and off, manage slots and their directives |
| Projects | List, create, rename |
| Brand DNA | Read, list and apply palettes, change the brand photo and logo |
| Radar | Read the latest analysis and the saved inspirations |
| Reports | Period summary and per-post performance |
| Team | List who is in the workspace |

> Connecting Instagram, paying, and changing plan do not cross into the API: all three are OAuth or checkout flows that need a browser. See the `excluded` list in the OpenAPI document for everything that stays out and why.

## Built for agents

Every page here answers in plain Markdown at the same URL with `.md` at the end, so an agent can fetch it without parsing HTML. There is also [/llms.txt](/llms.txt) for the index and [/docs/api/llms-full.txt](/docs/api/llms-full.txt) for this entire documentation in one file.

The machine contract is [the OpenAPI document](/docs/api/openapi.json), generated from the same registry that serves the requests, so it cannot drift from what the API actually does.