---
title: "Write several PLANNED articles one after another, and publish each one when publish is true: the next ones in calendar order (next), or the ones you name (contentIds). Each article follows Write now's rules: Auto-write off, next in line, up to 3 days before its day, at most 5 in any 24 hours. News and trending articles are written but never published by a run. Defaults to a DRY RUN that lists what would be written and what would stop it. When the person asked for this, call it with confirm=true. Follow progress with get_write_runs."
method: POST
path: "/api/v1/content/write-run"
---

# Write several PLANNED articles one after another, and publish each one when publish is true: the next ones in calendar order (next), or the ones you name (contentIds). Each article follows Write now's rules: Auto-write off, next in line, up to 3 days before its day, at most 5 in any 24 hours. News and trending articles are written but never published by a run. Defaults to a DRY RUN that lists what would be written and what would stop it. When the person asked for this, call it with confirm=true. Follow progress with get_write_runs.

`POST /api/v1/content/write-run`

## Request

- Base URL: `https://api.rctrl.com`
- URL: `https://api.rctrl.com/api/v1/content/write-run`
- Auth: HTTP bearer

Requires the `write:content` scope.

## Request body

- object
  - `next` number: How many of the next planned articles to write
  - `contentIds` string[]: Planned article ids, instead of next
  - `publish` boolean: Publish each article once it is written
  - `confirm` boolean: Set true to start (default: dry run)

## Response `200`

Success; the payload is wrapped in a data envelope

- object
  - `data` unknown

## Other responses

- `400`: Bad input
- `401`: Missing or invalid API key
- `403`: API key lacks the required scope
- `404`: Not found in this workspace
- `429`: Rate limited; the body includes a retryAfterMs hint

---

[API](https://skmtc.dev/rctrl/apis/rankcontrol-api.md) · [All operations](https://skmtc.dev/rctrl/apis/rankcontrol-api/llms.txt) · [OpenAPI document](https://skmtc.dev/rctrl/apis/rankcontrol-api/revisions/98ecd236394a?raw)