# Postify for AI agents

Machine-readable surfaces for building against Postify:

- [llms.txt](https://usepostify.com/llms.txt) — curated index of everything below
- [llms-full.txt](https://usepostify.com/llms-full.txt) — the full docs as one Markdown document
- Markdown twins of every developer-API page and product guide: append `.md` to its URL (e.g. `https://usepostify.com/docs/api-reference/posts/createPost.md`). The docs home's twin is `https://usepostify.com/docs/index.md`.
- [OpenAPI 3.1 spec](https://app.usepostify.com/v1/openapi.json) — all 17 operations with full schemas
- MCP server: `claude mcp add --transport http postify https://app.usepostify.com/api/mcp` — 15 tools over OAuth 2.1

## Guidelines for agents

- Auth: `Authorization: Bearer postify_live_…` (keys minted at https://app.usepostify.com/settings/api-keys).
- Honor `Retry-After` on 429 `rate_limited`; do NOT retry 429 `quota_exhausted` (monthly allowance — wait for reset or upgrade).
- Always send `Idempotency-Key` (a UUID) on POST /v1/posts so retries never double-post.
- `DELETE /v1/posts/{id}` and `POST /v1/posts/{id}/publish` need the workspace owner to enable "Dangerous AI operations" first — expect 403 `dangerous_ops_disabled` otherwise. Prefer drafting and letting a human publish.
- Dedup webhook deliveries on the `webhook-id` header (at-least-once delivery).

Agent paste-prompt:

```
Help me build against the Postify API. Read https://usepostify.com/llms.txt first — it indexes the guides and Markdown twins of every API page. Base URL: https://app.usepostify.com/v1, auth: Authorization: Bearer postify_live_… (I'll provide the key). Use Idempotency-Key on POST /v1/posts, honor Retry-After on 429, and note that delete/publish-now return 403 dangerous_ops_disabled until the workspace owner opts in.
```