> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://api.docs.siftsy.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://api.docs.siftsy.com/_mcp/server.

## 1.4.0

**Content routes.** Keys can now add content to a team the same way **Add New** works in the Siftsy app — same credits, same processing, programmatically. See [Adding content](/guides/core-concepts/adding-content).

* `POST /content/posts/add` — add up to 100 post URLs. Each accepted link reserves one MAP or Ad Hoc credit (5 with `capture.fullRead`), creates the post, and queues it. Links already on the team are `skipped`; unsupported hosts are `rejected`; neither is charged. Responds `202` with a `ContentJob`.
* `POST /content/accounts/add` — add a public account's recent posts (TikTok, Instagram, YouTube, Facebook pages, LinkedIn, X) using the app's account filters: `since`, `until`, `limit`, `keywords`, plus `minViews`, `minLikes`, and `postType`. Runs as a job (`discovering` → `syncing`). `dryRun: true` discovers and prices without adding.
* `GET /content/jobs/{jobId}` and `GET /content/jobs` — poll a job for `accepted` / `skipped` / `rejected` links, per-post processing status, and a credit accounting view (`reserved`, `settled`, `refunded`). Jobs settle to `completed`, `partial`, or `failed` and are kept for 30 days.
* **Collections by id or name.** `collections: [{ "id": "…" }]` or `[{ "name": "…" }]`; a name that matches an active collection is reused, otherwise a campaign is created (`created: true`). Ambiguous names return `409 collection_name_ambiguous` with candidates. `tags` merge onto the posts.
* **Enterprise sub-teams.** Enterprise keys may pass `teamId` to add content to (and spend the credits of) one of their sub-teams.
* **Idempotent.** An identical request returns the existing job (`200`, `meta.replayed: true`) instead of charging twice. A batch that cannot be funded at all returns `402` and creates nothing.

**Scopes.** Two new, **opt-in** scopes: `posts:write` and `accounts:write`. They are not granted by default; a team admin enables them per key in **Team Settings → API**. Existing keys are unchanged and cannot add content until rotated with the new scopes.

**Rate limits.** New classes `content_add_posts` (10/min, 200/day), `content_add_accounts` (2/min, 20/day), and `content_jobs` (60/min, 2,000/day). `GET /me` lists them under `rateLimit.routeClasses`.

**Posts.** `Post.addedVia` is `api` for posts created through the content routes and `dashboard` otherwise. Posts added through the API also appear in the app for the team, like any upload.