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.