CLI REFERENCE
Article commands Signatures, flags and examples for recala article.
On this page Use these commands Read, edit, review, approve, schedule and unpublish articles.
Examples assume you have signed in and selected the intended organization. Set shell variables such as ARTICLE_ID to ids from the corresponding list command. Set PUBLICATION_TIME to a future local time in YYYY-MM-DDTHH:MM format.
Badges describe the command’s strongest effect; a preview or read-only option may do less. Guarded writes can require confirmation even without --yes . “Needs a person” covers identity, consent and credentials.
Approve the article: the named person signs it (a key needs publish; its owner is on record).
Signature Copy
recala article approve ARTICLE_ID [OPTIONS] Replace uppercase arguments with your own values. Replace [OPTIONS] with the flags you need, or omit it.
Scroll horizontally to see all columns →
Flag Required Description --jsonNo Print one JSON document (errors as JSON on stderr). --orgNo Organization name, slug or id (else RECALA_ORG, else recala org use). --yesNo Only with an API key holding publish: approve, schedule or unpublish without a prompt.
Examples Approve it in the named author's name; who ran the command is recorded. This is the signature, so confirm it in your terminal.
Terminal Copy
recala article approve "$ARTICLE_ID" Exit codes: 0 OK1 ERROR2 USAGE3 NOT_AUTHENTICATED4 FORBIDDEN5 NOT_FOUND6 CONFLICT7 INVALID8 RATE_LIMITED9 UNAVAILABLE10 CONFIRMATION_REQUIRED11 PAYMENT_REQUIRED
API commands share the CLI’s HTTP error mapping. Read human and JSON output rules .
Comments left through the review link.
read Acts on an organization
Signature Copy
recala article comments ARTICLE_ID [OPTIONS] Replace uppercase arguments with your own values. Replace [OPTIONS] with the flags you need, or omit it.
Scroll horizontally to see all columns →
Flag Required Description --jsonNo Print one JSON document (errors as JSON on stderr). --orgNo Organization name, slug or id (else RECALA_ORG, else recala org use).
Examples Set the named shell variables to your own values before running.
Terminal Copy
recala article comments "$ARTICLE_ID" Exit codes: 0 OK1 ERROR2 USAGE3 NOT_AUTHENTICATED4 FORBIDDEN5 NOT_FOUND6 CONFLICT7 INVALID8 RATE_LIMITED9 UNAVAILABLE11 PAYMENT_REQUIRED
API commands share the CLI’s HTTP error mapping. Read human and JSON output rules .
Write a new article from a topic. Uses one article of the plan; always previews the cost first.
Signature Copy
recala article create [OPTIONS] Replace [OPTIONS] with your flags. Include every flag marked Required in the table below.
Scroll horizontally to see all columns →
Flag Required Description --jsonNo Print one JSON document (errors as JSON on stderr). --orgNo Organization name, slug or id (else RECALA_ORG, else recala org use). --yesNo Only with an API key holding publish: approve, schedule or unpublish without a prompt. --topicYes The topic id (recala topics list) to write. --dry-runNo Show the cost preview and the balance; spend nothing. --no-waitNo Start the run and return its id immediately.
Examples Preview the cost and the balance. Nothing is spent.
Terminal Copy
recala article create --topic "$TOPIC_ID" --dry-run Write the article. It uses one article of the plan, so confirm it in your terminal.
Terminal Copy
recala article create --topic "$TOPIC_ID" Exit codes: 0 OK1 ERROR2 USAGE3 NOT_AUTHENTICATED4 FORBIDDEN5 NOT_FOUND6 CONFLICT7 INVALID8 RATE_LIMITED9 UNAVAILABLE10 CONFIRMATION_REQUIRED11 PAYMENT_REQUIRED
API commands share the CLI’s HTTP error mapping. Read human and JSON output rules .
Edit the text (--body-file), ask for an AI edit (--ai "notes"), or keep an AI draft (--apply).
writes Acts on an organization
Signature Copy
recala article edit ARTICLE_ID [OPTIONS] Replace uppercase arguments with your own values. Replace [OPTIONS] with the flags you need, or omit it.
Scroll horizontally to see all columns →
Flag Required Description --jsonNo Print one JSON document (errors as JSON on stderr). --orgNo Organization name, slug or id (else RECALA_ORG, else recala org use). --body-fileNo Replace the text with this Markdown file. --aiNo An AI edit: one note per --ai (a paid model call; 3 per article). --waitNo With --ai: wait until the AI draft is ready. --timeoutNo No description supplied by the CLI. --applyNo Keep the finished AI draft's changes (all but --undo). --undoNo With --apply: comma-separated change numbers to undo, e.g. 2,5.
Examples Run in your terminal with the intended organization selected.
Terminal Copy
recala article edit "$ARTICLE_ID" --ai "Shorter introduction" --wait Exit codes: 0 OK1 ERROR2 USAGE3 NOT_AUTHENTICATED4 FORBIDDEN5 NOT_FOUND6 CONFLICT7 INVALID8 RATE_LIMITED9 UNAVAILABLE10 CONFIRMATION_REQUIRED11 PAYMENT_REQUIRED
API commands share the CLI’s HTTP error mapping. Read human and JSON output rules .
The company's articles, newest first.
read Acts on an organization
Signature Copy
recala article list [OPTIONS] Replace [OPTIONS] with the flags you need, or omit it.
Scroll horizontally to see all columns →
Flag Required Description --jsonNo Print one JSON document (errors as JSON on stderr). --orgNo Organization name, slug or id (else RECALA_ORG, else recala org use). --limitNo No description supplied by the CLI. --offsetNo No description supplied by the CLI.
Examples Or name the organization for one command with --org.
Terminal Copy
recala article list --org rebeam Or set RECALA_ORG for a shell, a script or an agent.
Terminal Copy
RECALA_ORG=rebeam recala article list Exit codes: 0 OK1 ERROR2 USAGE3 NOT_AUTHENTICATED4 FORBIDDEN5 NOT_FOUND6 CONFLICT7 INVALID8 RATE_LIMITED9 UNAVAILABLE11 PAYMENT_REQUIRED
API commands share the CLI’s HTTP error mapping. Read human and JSON output rules .
Link the article to the named person who will sign it.
writes Acts on an organization
Signature Copy
recala article person ARTICLE_ID [OPTIONS] Replace uppercase arguments with your own values. Replace [OPTIONS] with your flags. Include every flag marked Required in the table below.
Scroll horizontally to see all columns →
Flag Required Description --jsonNo Print one JSON document (errors as JSON on stderr). --orgNo Organization name, slug or id (else RECALA_ORG, else recala org use). --personYes The author (recala authors list) who signs this article.
Examples Link the article to the real person who will sign it.
Terminal Copy
recala article person "$ARTICLE_ID" --person "$AUTHOR_ID" Exit codes: 0 OK1 ERROR2 USAGE3 NOT_AUTHENTICATED4 FORBIDDEN5 NOT_FOUND6 CONFLICT7 INVALID8 RATE_LIMITED9 UNAVAILABLE10 CONFIRMATION_REQUIRED11 PAYMENT_REQUIRED
API commands share the CLI’s HTTP error mapping. Read human and JSON output rules .
Check an edited article again and show what still blocks approval.
writes Acts on an organization
Signature Copy
recala article recheck ARTICLE_ID [OPTIONS] Replace uppercase arguments with your own values. Replace [OPTIONS] with the flags you need, or omit it.
Scroll horizontally to see all columns →
Flag Required Description --jsonNo Print one JSON document (errors as JSON on stderr). --orgNo Organization name, slug or id (else RECALA_ORG, else recala org use).
Examples Set the named shell variables to your own values before running.
Terminal Copy
recala article recheck "$ARTICLE_ID" Exit codes: 0 OK1 ERROR2 USAGE3 NOT_AUTHENTICATED4 FORBIDDEN5 NOT_FOUND6 CONFLICT7 INVALID8 RATE_LIMITED9 UNAVAILABLE10 CONFIRMATION_REQUIRED11 PAYMENT_REQUIRED
API commands share the CLI’s HTTP error mapping. Read human and JSON output rules .
Preview a held article's re-run cost, confirm, and wait for review or another hold.
Signature Copy
recala article regenerate ARTICLE_ID [OPTIONS] Replace uppercase arguments with your own values. Replace [OPTIONS] with the flags you need, or omit it.
Scroll horizontally to see all columns →
Flag Required Description --jsonNo Print one JSON document (errors as JSON on stderr). --orgNo Organization name, slug or id (else RECALA_ORG, else recala org use). --yesNo Only with an API key holding publish: approve, schedule or unpublish without a prompt.
Examples Set the named shell variables to your own values before running.
Terminal Copy
recala article regenerate "$ARTICLE_ID" Exit codes: 0 OK1 ERROR2 USAGE3 NOT_AUTHENTICATED4 FORBIDDEN5 NOT_FOUND6 CONFLICT7 INVALID8 RATE_LIMITED9 UNAVAILABLE10 CONFIRMATION_REQUIRED11 PAYMENT_REQUIRED
API commands share the CLI’s HTTP error mapping. Read human and JSON output rules .
Send the article back with a change request.
writes Acts on an organization
Signature Copy
recala article request-changes ARTICLE_ID [OPTIONS] Replace uppercase arguments with your own values. Replace [OPTIONS] with your flags. Include every flag marked Required in the table below.
Scroll horizontally to see all columns →
Flag Required Description --jsonNo Print one JSON document (errors as JSON on stderr). --orgNo Organization name, slug or id (else RECALA_ORG, else recala org use). --noteYes What should change.
Examples Set the named shell variables to your own values before running.
Terminal Copy
recala article request-changes "$ARTICLE_ID" --note "$NOTE" Exit codes: 0 OK1 ERROR2 USAGE3 NOT_AUTHENTICATED4 FORBIDDEN5 NOT_FOUND6 CONFLICT7 INVALID8 RATE_LIMITED9 UNAVAILABLE10 CONFIRMATION_REQUIRED11 PAYMENT_REQUIRED
API commands share the CLI’s HTTP error mapping. Read human and JSON output rules .
Wait for an existing creation run; never starts or pays for another run.
read Acts on an organization
Signature Copy
recala article run QUEUE_ID [OPTIONS] Replace uppercase arguments with your own values. Replace [OPTIONS] with the flags you need, or omit it.
Scroll horizontally to see all columns →
Flag Required Description --jsonNo Print one JSON document (errors as JSON on stderr). --orgNo Organization name, slug or id (else RECALA_ORG, else recala org use).
Examples Set the named shell variables to your own values before running.
Terminal Copy
recala article run "$QUEUE_ID" Exit codes: 0 OK1 ERROR2 USAGE3 NOT_AUTHENTICATED4 FORBIDDEN5 NOT_FOUND6 CONFLICT7 INVALID8 RATE_LIMITED9 UNAVAILABLE11 PAYMENT_REQUIRED
API commands share the CLI’s HTTP error mapping. Read human and JSON output rules .
Schedule an approved article to publish at a time.
Signature Copy
recala article schedule ARTICLE_ID [OPTIONS] Replace uppercase arguments with your own values. Replace [OPTIONS] with your flags. Include every flag marked Required in the table below.
Scroll horizontally to see all columns →
Flag Required Description --jsonNo Print one JSON document (errors as JSON on stderr). --orgNo Organization name, slug or id (else RECALA_ORG, else recala org use). --yesNo Only with an API key holding publish: approve, schedule or unpublish without a prompt. --atYes Local time in the company's timezone, e.g. 2026-10-06T09:00. --tzNo Timezone (default: the company's). --dry-runNo Show whether it can be scheduled; change nothing.
Examples Check that the article can be scheduled. Nothing changes.
Terminal Copy
recala article schedule "$ARTICLE_ID" --at "$PUBLICATION_TIME" --dry-run Schedule it in the company's timezone. It publishes at that time without asking again.
Terminal Copy
recala article schedule "$ARTICLE_ID" --at "$PUBLICATION_TIME" Exit codes: 0 OK1 ERROR2 USAGE3 NOT_AUTHENTICATED4 FORBIDDEN5 NOT_FOUND6 CONFLICT7 INVALID8 RATE_LIMITED9 UNAVAILABLE10 CONFIRMATION_REQUIRED11 PAYMENT_REQUIRED
API commands share the CLI’s HTTP error mapping. Read human and JSON output rules .
Show the review link; --review-link makes one; --rotate / --revoke kill the old one (need --yes).
Signature Copy
recala article share ARTICLE_ID [OPTIONS] Replace uppercase arguments with your own values. Replace [OPTIONS] with the flags you need, or omit it.
Scroll horizontally to see all columns →
Flag Required Description --jsonNo Print one JSON document (errors as JSON on stderr). --orgNo Organization name, slug or id (else RECALA_ORG, else recala org use). --yesNo Only with an API key holding publish: approve, schedule or unpublish without a prompt. --review-linkNo Turn the review link on (or replace it). --rotateNo Replace the article's share token; the old link stops working. --revokeNo Turn the review link off.
Examples Make a review link for the person.
Terminal Copy
recala article share "$ARTICLE_ID" --review-link Exit codes: 0 OK1 ERROR2 USAGE3 NOT_AUTHENTICATED4 FORBIDDEN5 NOT_FOUND6 CONFLICT7 INVALID8 RATE_LIMITED9 UNAVAILABLE10 CONFIRMATION_REQUIRED11 PAYMENT_REQUIRED
API commands share the CLI’s HTTP error mapping. Read human and JSON output rules .
One article: status, author, hold, open questions (and the text with --markdown).
read Acts on an organization
Signature Copy
recala article show ARTICLE_ID [OPTIONS] Replace uppercase arguments with your own values. Replace [OPTIONS] with the flags you need, or omit it.
Scroll horizontally to see all columns →
Flag Required Description --jsonNo Print one JSON document (errors as JSON on stderr). --orgNo Organization name, slug or id (else RECALA_ORG, else recala org use). --markdownNo Include the article's text.
Examples Read the text, any hold and the open questions.
Terminal Copy
recala article show "$ARTICLE_ID" --markdown Exit codes: 0 OK1 ERROR2 USAGE3 NOT_AUTHENTICATED4 FORBIDDEN5 NOT_FOUND6 CONFLICT7 INVALID8 RATE_LIMITED9 UNAVAILABLE11 PAYMENT_REQUIRED
API commands share the CLI’s HTTP error mapping. Read human and JSON output rules .
Where the article stands: review, publishing, author, hold, versions, review link.
read Acts on an organization
Signature Copy
recala article status ARTICLE_ID [OPTIONS] Replace uppercase arguments with your own values. Replace [OPTIONS] with the flags you need, or omit it.
Scroll horizontally to see all columns →
Flag Required Description --jsonNo Print one JSON document (errors as JSON on stderr). --orgNo Organization name, slug or id (else RECALA_ORG, else recala org use).
Examples Review, publishing, author, hold, versions and review link for one article.
Terminal Copy
recala article status "$ARTICLE_ID" Exit codes: 0 OK1 ERROR2 USAGE3 NOT_AUTHENTICATED4 FORBIDDEN5 NOT_FOUND6 CONFLICT7 INVALID8 RATE_LIMITED9 UNAVAILABLE11 PAYMENT_REQUIRED
API commands share the CLI’s HTTP error mapping. Read human and JSON output rules .
Hand the article over for the person's review.
writes Acts on an organization
Signature Copy
recala article submit ARTICLE_ID [OPTIONS] Replace uppercase arguments with your own values. Replace [OPTIONS] with the flags you need, or omit it.
Scroll horizontally to see all columns →
Flag Required Description --jsonNo Print one JSON document (errors as JSON on stderr). --orgNo Organization name, slug or id (else RECALA_ORG, else recala org use).
Examples Hand it over for that person's review.
Terminal Copy
recala article submit "$ARTICLE_ID" Exit codes: 0 OK1 ERROR2 USAGE3 NOT_AUTHENTICATED4 FORBIDDEN5 NOT_FOUND6 CONFLICT7 INVALID8 RATE_LIMITED9 UNAVAILABLE10 CONFIRMATION_REQUIRED11 PAYMENT_REQUIRED
API commands share the CLI’s HTTP error mapping. Read human and JSON output rules .
Take a published article off the site (the CMS first).
Signature Copy
recala article unpublish ARTICLE_ID [OPTIONS] Replace uppercase arguments with your own values. Replace [OPTIONS] with the flags you need, or omit it.
Scroll horizontally to see all columns →
Flag Required Description --jsonNo Print one JSON document (errors as JSON on stderr). --orgNo Organization name, slug or id (else RECALA_ORG, else recala org use). --yesNo Only with an API key holding publish: approve, schedule or unpublish without a prompt.
Examples Take a published article off the site.
Terminal Copy
recala article unpublish "$ARTICLE_ID" Exit codes: 0 OK1 ERROR2 USAGE3 NOT_AUTHENTICATED4 FORBIDDEN5 NOT_FOUND6 CONFLICT7 INVALID8 RATE_LIMITED9 UNAVAILABLE10 CONFIRMATION_REQUIRED11 PAYMENT_REQUIRED
API commands share the CLI’s HTTP error mapping. Read human and JSON output rules .
Cancel the article's scheduled publication.
Signature Copy
recala article unschedule ARTICLE_ID [OPTIONS] Replace uppercase arguments with your own values. Replace [OPTIONS] with the flags you need, or omit it.
Scroll horizontally to see all columns →
Flag Required Description --jsonNo Print one JSON document (errors as JSON on stderr). --orgNo Organization name, slug or id (else RECALA_ORG, else recala org use). --yesNo Only with an API key holding publish: approve, schedule or unpublish without a prompt.
Examples Cancel a scheduled publication.
Terminal Copy
recala article unschedule "$ARTICLE_ID" Exit codes: 0 OK1 ERROR2 USAGE3 NOT_AUTHENTICATED4 FORBIDDEN5 NOT_FOUND6 CONFLICT7 INVALID8 RATE_LIMITED9 UNAVAILABLE10 CONFIRMATION_REQUIRED11 PAYMENT_REQUIRED
API commands share the CLI’s HTTP error mapping. Read human and JSON output rules .
Every saved version of the article, or one of them with --show N.
read Acts on an organization
Signature Copy
recala article versions ARTICLE_ID [OPTIONS] Replace uppercase arguments with your own values. Replace [OPTIONS] with the flags you need, or omit it.
Scroll horizontally to see all columns →
Flag Required Description --jsonNo Print one JSON document (errors as JSON on stderr). --orgNo Organization name, slug or id (else RECALA_ORG, else recala org use). --showNo One version's text and changes.
Examples Read what changed.
Terminal Copy
recala article versions "$ARTICLE_ID" Exit codes: 0 OK1 ERROR2 USAGE3 NOT_AUTHENTICATED4 FORBIDDEN5 NOT_FOUND6 CONFLICT7 INVALID8 RATE_LIMITED9 UNAVAILABLE11 PAYMENT_REQUIRED
API commands share the CLI’s HTTP error mapping. Read human and JSON output rules .