CLI REFERENCE
Authors commands Signatures, flags and examples for recala authors.
On this page Use these commands The real people who sign 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.
The author alias is included below with its own command anchors.
Add a person who signs articles (owners).
needs a person Acts on an organization
Signature Copy
recala author add [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). --nameYes Full name as it appears on the byline. --title, --roleNo Job title, e.g. "Founder". --link, --bio-linkNo A public profile or bio link. Repeat for each. --linkedinNo The LinkedIn profile (else the first --link on linkedin.com). --bioNo One or two sentences. --expertiseNo A topic this person knows. Repeat for each.
Examples Run in your terminal with the intended organization selected.
Terminal Copy
recala author add --name "$AUTHOR_NAME" --title "$AUTHOR_TITLE" 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 author of the company.
read Acts on an organization
Signature Copy
recala author 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).
Examples Set the named shell variables to your own values before running.
Terminal Copy
recala author 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 .
Add a person who signs articles (owners).
needs a person Acts on an organization
Signature Copy
recala authors add [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). --nameYes Full name as it appears on the byline. --title, --roleNo Job title, e.g. "Founder". --link, --bio-linkNo A public profile or bio link. Repeat for each. --linkedinNo The LinkedIn profile (else the first --link on linkedin.com). --bioNo One or two sentences. --expertiseNo A topic this person knows. Repeat for each.
Examples Run in your terminal with the intended organization selected.
Terminal Copy
recala authors add --name "$AUTHOR_NAME" --title "$AUTHOR_TITLE" 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 author of the company.
read Acts on an organization
Signature Copy
recala authors 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).
Examples See the real people who can sign articles for this organization.
Terminal Copy
recala authors 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 .