Push an article from a connected site
Called by a CMS plugin (e.g. WordPress) when a post is published or updated. Stores the article for the connection's automation rules; enabled rules then create drafts or scheduled posts. Re-pushing the same URL updates the stored article instead of duplicating it. Rate limit: 30 requests per minute per token.
Authorization
SiteConnectionToken A Site Connection token created in the dashboard (Settings > Sites). Scoped to one connected site: it can only push that site's articles and read that connection's status. Personal API keys and dashboard sessions cannot call Site Push endpoints, and this token cannot call any other endpoint.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/site_pushes" \ -H "Content-Type: application/json" \ -d '{ "action": "publish", "url": "https://example.com/2026/07/hello-world/", "title": "Hello World", "body_html": "<p>Article body.</p>", "excerpt": "Article excerpt.", "post_type": "post", "published_at": "2026-07-28T14:45:00Z", "author": { "display_name": "John" }, "taxonomies": { "category": [ "Engineering" ] } }'{ "id": 0, "url": "string", "action": "publish", "received_at": "2019-08-24T14:15:22Z"}Regenerate a failed Quote Week item POST
Requires scope: `image_week:write`. Reprocesses a single `failed` item — resets its attempt count and re-enqueues generation → verify → post-build → slot-fill for that item alone. Only `failed` items can be regenerated (422 `INVALID_STATE` otherwise).
Get the connection's status and recent pushes GET
Read-only status for the authenticated Site Connection: connection details, its automation rules, and the 10 most recent pushed articles. Powers the plugin's Test Connection button and status displays.