Skip to main content

​
updates.page CLI

The @updatespage/cli package lets you create and publish posts from your terminal — perfect for release scripts and CI pipelines.
The CLI uses the updates.page API, which is available on the Business plan.

​
Installation

Requires Node.js 20+.

​
Setup

Create an API key in the dashboard under Account → API Keys (see Authentication), then configure the CLI:
The CLI talks to https://app.updates.page by default. For a self-hosted instance, pass --url:
Configuration is stored at ~/.updatespage/config.json.

​
Commands

​
Publish a post

Optionally assign a category:
Run updates categories to find your category IDs.

​
Create a draft

Creates the post without publishing it:

​
List posts

Filter by status:

​
Get a post

​
List categories

​
Using in CI

Store your API key as a secret in your CI provider and configure the CLI in your release step:

​
Going further

The CLI covers the most common workflows. For everything else — scheduling, unpublishing, deleting, managing categories — use the REST API directly.