Skip to content

Post commands: publish, schedule, withdraw

The Post Verbs publish, schedule, withdraw as CLI commands, with inputs, result, refusals and an example.

Reference for Post, one group of Post commands.

Post.publish

Publish sends a Post out through its Handle once every claim it states resolves to a live record. Verb page.

Text
npx startup-builder do Post.publish --json '<input>' [--try | --send | --do]

Emits Post.published.

Inputs

InputTypeRequiredDescription
postPostrequiredThe Post to publish.

Returns

OutputTypeRequiredDescription
postPostrequiredThe published Post.

Refuses when

CheckErrorFixThen call
The key is valid, but its scopes do not allow this operation.forbiddenUse a key whose scopes cover the operation, or ask an owner of the namespace to grant them.None.

Example

Terminal
npx startup-builder do Post.publish --json '{"post":"post_HiXn57rBdP"}'

Post.schedule

Schedule puts a drafted Post on its Handle’s calendar for a set time. Verb page.

Text
npx startup-builder do Post.schedule --json '<input>' [--try | --send | --do]

Emits Post.scheduled.

Inputs

InputTypeRequiredDescription
postPostrequiredThe drafted Post.
atdatetimerequiredWhen it goes out.

Returns

OutputTypeRequiredDescription
postPostrequiredThe scheduled Post.

Refuses when

CheckErrorFixThen call
The key is valid, but its scopes do not allow this operation.forbiddenUse a key whose scopes cover the operation, or ask an owner of the namespace to grant them.None.

Example

Terminal
npx startup-builder do Post.schedule --json '{"post":"post_HiXn57rBdP","at":"2026-10-22T12:00:00Z"}'

Post.withdraw

Withdraw takes a published Post down from its venue and keeps the record, its reach and its replies. Verb page.

Text
npx startup-builder do Post.withdraw --json '<input>' [--try | --send | --do]

Emits Post.withdrawn.

Inputs

InputTypeRequiredDescription
postPostrequiredThe Post to take down.
reasontextrequiredWhy it comes down.

Returns

OutputTypeRequiredDescription
postPostrequiredThe withdrawn Post.

Refuses when

CheckErrorFixThen call
The key is valid, but its scopes do not allow this operation.forbiddenUse a key whose scopes cover the operation, or ask an owner of the namespace to grant them.None.

Example

Terminal
npx startup-builder do Post.withdraw --json '{"post":"post_HiXn57rBdP","reason":"Example reason"}'