fiftyeight auth login # paste the key from API & MCP; it is checked, then saved
fiftyeight auth status
The key is saved in ~/.config/fiftyeight/config.json, readable only by you. In CI or scripts, set FIFTYEIGHT_API_KEY instead: it takes precedence over the saved key, and --api-key over both. FIFTYEIGHT_API_URL or --api-url points the CLI at another API.
Commands print a short, readable summary. Add --json right after fiftyeight to get the raw API response instead.
Errors print the API's message with its status, for example Error: 409 Cannot cancel a post that is published, and exit with status 1. A usage mistake (missing option, no key) exits with 2.
Checks the key against the API, then saves it (prompts for it if --key is omitted).
fiftyeight auth status
Shows the API URL, where the key comes from, and the workspace mode.
fiftyeight auth logout
Removes the saved key.
accounts and brands
Command
What it does
fiftyeight accounts list [--brand ID]
Id, platform, publishing language and status of each account.
fiftyeight accounts connect PLATFORM [--brand ID]
Prints a link the account owner opens to connect instagram, tiktok, youtube, facebook, linkedin, twitter, threads, pinterest or bluesky.
fiftyeight accounts sync [--brand ID]
Refreshes accounts after connecting one.
fiftyeight accounts set ID [--language es] [--timezone Europe/Paris] [--optimize|--no-optimize]
Publishing language (decides which dubbed version it receives), audience timezone, best-time optimizer.
fiftyeight accounts link NAME ID ID [ID…]
Links accounts as language versions (e.g. @atlas FR and @atlas.en EN): dubbed versions go to the linked account of each language.
fiftyeight accounts groups
Lists linked language versions.
fiftyeight accounts suggest
Shows unlinked accounts that look like language versions of each other.
fiftyeight accounts unlink GROUP [--account ID]
Unlinks one account, or the whole group.
fiftyeight accounts remove ID [--yes]
Removes an account from the workspace. Accounts Fifty Eight connected are disconnected; shared ones are only hidden. --yes confirms cancelling its scheduled posts.
fiftyeight accounts restore ID
Shows a hidden (shared) account again.
fiftyeight brands list
Lists brands.
fiftyeight brands create NAME [--locale fr]
Creates a brand.
media
Command
What it does
fiftyeight media upload FILE
Uploads a video or image (type from the file extension) and prints its media id.
posts
Command
What it does
fiftyeight posts create -a ACCOUNT [-a ACCOUNT…] (--now | --schedule TIME | --draft) [options]
Answers comments containing the keyword with a DM and a link button. Add --reply for a public reply (repeat it up to 3 times: one is picked at random for each comment), --post ID for one post, --trigger story|live.
fiftyeight automations list
Your automations with replies sent and skipped, then the imported ones.
fiftyeight automations update ID --reply "Sent you a DM!" --reply "Check your DMs, {{first_name}}"
Changes the texts or keywords: --name, -k, --dm, --reply (replaces the current replies, up to 3), --no-reply.
fiftyeight automations disable ID
Pauses an automation (yours or an imported one). enable turns it back on, delete removes it.
fiftyeight automations usage
Replies used this month against your quota and per-video limit.
credits and timing
Command
What it does
fiftyeight credits
Credits left, what your plan adds each month, what everything costs, automatic top-up and this month's budget.
fiftyeight credits estimate 45 -l 2 [--lipsync]
What a dub will cost before starting it ("This dub: 90 credits").
fiftyeight credits history [-n 25]
Credit movements, newest first, with the balance after each.
fiftyeight credits topup
Points you to Plan & credits in the dashboard: buying credits, plans and automatic top-up are done there by an owner or admin, never with an API key.
fiftyeight timing
Best posting times learned per account.
The CLI only calls the public API: anything it does, your own code can do with the same requests. See the API reference.
