CLI REFERENCE
Org commands Signatures, flags and examples for recala org.
On this page Use these commands Choose and show the organization you act on.
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 company alias is included below with its own command anchors.
Create the company (or set up the empty one a new account starts with) and make it active.
needs a person Acts on an organization
Signature Copy
recala company create [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). --nameNo The company's name, as readers know it. --websiteNo Its website, e.g. https://cometa.cards --languageNo The language it publishes in (ISO code, e.g. es). --marketNo The country it sells in (ISO code, e.g. ES).
Examples Run in your terminal with the intended organization selected.
Terminal Copy
recala company create 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 company this credential may act on; * marks the active one.
read Acts on an organization
Signature Copy
recala company 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 company 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 .
Read the company's website (brand, products, audiences, competitors) and save what you confirm.
needs a person Acts on an organization
Signature Copy
recala company scan [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). --websiteNo Read this address instead of the company's website.
Examples Run in your terminal with the intended organization selected.
Terminal Copy
recala company scan 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 active company's identity.
read Acts on an organization
Signature Copy
recala company show [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 company show 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 .
Organization name, slug or id: choose the company later commands act on.
writes
Signature Copy
recala company use ORG_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).
Examples Set the named shell variables to your own values before running.
Terminal Copy
recala company use "$ORG_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 .
Create the company (or set up the empty one a new account starts with) and make it active.
needs a person Acts on an organization
Signature Copy
recala org create [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). --nameNo The company's name, as readers know it. --websiteNo Its website, e.g. https://cometa.cards --languageNo The language it publishes in (ISO code, e.g. es). --marketNo The country it sells in (ISO code, e.g. ES).
Examples Run in your terminal with the intended organization selected.
Terminal Copy
recala org create 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 company this credential may act on; * marks the active one.
read Acts on an organization
Signature Copy
recala org 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 Every organization you may act on. A star marks the active one.
Terminal Copy
recala org 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 .
Read the company's website (brand, products, audiences, competitors) and save what you confirm.
needs a person Acts on an organization
Signature Copy
recala org scan [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). --websiteNo Read this address instead of the company's website.
Examples Run in your terminal with the intended organization selected.
Terminal Copy
recala org scan 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 active company's identity.
read Acts on an organization
Signature Copy
recala org show [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 The active organization's name, website and blog.
Terminal Copy
recala org show Check that the active organization is the one the person meant.
Terminal Copy
recala org show --json 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 .
Organization name, slug or id: choose the company later commands act on.
writes
Signature Copy
recala org use ORG_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).
Examples Make it the organization later commands act on. Use its name, slug or id; the choice is saved on this machine.
Terminal Copy
recala org use "$ORG" 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 .