Command reference
Find every command in the Simplified client CLI and the inputs it accepts.
This reference covers all 77 commands in simplified-cli 1.8.0. Run a command
with --help for its flag types, required inputs, defaults, and accepted values.
The linked guides show how to combine commands into complete workflows.
simplified --helpsimplified posts:create --help
Global options
| Option | Purpose |
|---|---|
--api-key | Override the credential for this command. Prefer a saved profile or a CI secret for routine use. |
--teamspace | Override the context with a numeric teamspace ID or a saved alias. |
--help, -h | Show usage without performing the command. |
--version, -v | Print the installed version. |
Options below use their long names. Not every option is required or compatible
with every other input mode. A --json flag reads a file; it is not an output
format switch. See automation for output handling.
Authentication
| Command | What it does | Command-specific options |
|---|---|---|
auth:whoami | Show the default workspace and teamspaces accessible to the current token | No command-specific flags. |
auth:login <name> | Save an API key under a profile name and make it the active key | No command-specific flags. |
auth:use <name> | Switch the active API key profile | No command-specific flags. |
auth:list | List saved API key profiles and mark the active one | No command-specific flags. |
auth:logout [name] | Remove an API key profile (defaults to the active one) | No command-specific flags. |
Teamspaces
| Command | What it does | Command-specific options |
|---|---|---|
teamspace:current | Show the active teamspace context and where it came from | No command-specific flags. |
teamspace:use <target> | Switch the active teamspace (id, saved alias, or “default” for the default workspace) | No command-specific flags. |
teamspace:add <alias> <id> | Save an alias for a teamspace id | No command-specific flags. |
teamspace:list | List saved teamspace aliases and mark the active one | No command-specific flags. |
teamspace:remove <alias> | Remove a saved teamspace alias | No command-specific flags. |
Connected accounts
| Command | What it does | Command-specific options |
|---|---|---|
accounts:list | List connected social media accounts | --network |
Posts and drafts
| Command | What it does | Command-specific options |
|---|---|---|
posts:create | Create, schedule, queue or draft a social media post | --content · --accounts · --action · --date · --media · --media-json · --comment · --comments · --additional · --group · --json |
posts:list | List scheduled/published posts for given accounts | --accounts · --page · --per-page · --category · --tz · --search · --query |
posts:list-drafts | List drafts for given accounts | --accounts · --page · --per-page · --search · --tz · --order-by · --order |
posts:delete | Delete a scheduled post by group ID or post-schedule ID | --group-id · --post-schedule-id |
posts:delete-draft | Delete draft(s) by group ID or draft IDs | --group-id · --draft-ids |
posts:update | Update a scheduled post | --post-id · --content · --date · --time · --timezone · --media · --media-json |
posts:update-draft | Update a draft | --draft-id · --content · --date · --time · --timezone · --media · --media-json |
Review bundles
| Command | What it does | Command-specific options |
|---|---|---|
review-bundle:create | Create a social media review bundle, optionally seeded with drafts | --title · --description · --draft-ids |
review-bundle:add-drafts | Add drafts to an existing review bundle | --bundle-id · --draft-ids |
Analytics
| Command | What it does | Command-specific options |
|---|---|---|
analytics:range | Get time-series metrics for a social media account | --account · --metrics · --from · --to · --tz |
analytics:posts | Get per-post analytics for a social media account | --account · --from · --to · --page · --per-page |
analytics:aggregated | Get aggregated KPIs (impressions, engagement, followers, publishing) | --account · --from · --to |
analytics:audience | Get audience demographics (followers, gender, country breakdown) | --account · --from · --to · --tz |
Assets
| Command | What it does | Command-specific options |
|---|---|---|
assets:get | Get asset details by ID | --id |
assets:upload | Upload a local file as a workspace asset (image, video, audio, PDF) | --file · --name |
assets:import | Import a remote URL (S3, GCP, CDN) as a workspace asset | --url · --name |
AI images
| Command | What it does | Command-specific options |
|---|---|---|
ai-image:generate | Generate an image using AI from a text prompt or reference image | --model · --capability · --prompt · --aspect-ratio · --count · --negative-prompt · --reference-images · --seed · --properties · --wait |
ai-image:status | Check the status of an AI image generation task | --id |
ai-image:models | List available AI image generation models with capabilities and pricing | --model-id · --capability |
AI video
| Command | What it does | Command-specific options |
|---|---|---|
ai-video:generate | Generate an AI video from a prompt or reference image (Veo, Sora, Kling, etc.) | --model · --capability · --prompt · --aspect-ratio · --duration · --resolution · --negative-prompt · --reference-images · --generate-audio · --parameters · --storage · --wait |
ai-video:status | Check the status of an AI video generation job | --art-id · --id |
ai-video:models | List available AI video models with capabilities and per-model fields | --model-id · --capability |
Image editing
| Command | What it does | Command-specific options |
|---|---|---|
image:blur-background | Blur the background of an image (synchronous) | --url · --blur |
image:remove-background | Remove or replace the background of an image | --url · --magic-crop · --bg-color · --format · --wait |
image:convert | Convert an image to a different format | --url · --format · --wait |
image:upscale | Upscale image resolution (2x, 4x or 8x) | --url · --scale · --wait |
image:restore | Restore and enhance a photo | --url · --scale · --wait |
image:generative-fill | AI-powered generative fill / inpainting with a prompt | --url · --prompt · --mask-url · --negative-prompt · --count · --wait |
image:outpaint | Extend image content beyond its borders | --url · --mask-url · --prompt · --negative-prompt · --guidance-scale · --count · --wait |
image:magic-inpaint | Place an object or subject into a scene using AI | --url · --prompt · --scale · --wait |
image:pix-to-pix | Transform an image using a text prompt | --url · --prompt · --guidance-scale · --count · --wait |
image:replace | Replace image background with transparent, a color, or another image | --url · --replace-type · --replace-color · --replace-image · --wait |
image:sd-scribble | Generate image from a sketch/scribble using Stable Diffusion | --prompt · --negative-prompt · --url · --resolution · --steps · --guidance-scale · --count · --wait |
image:task | Check the status of an async image processing task | --id |
Video editing and production
| Command | What it does | Command-specific options |
|---|---|---|
video:add-b-rolls | Add B-rolls to a video | --title · --media-url · --asset · --language-code · --should-export · --wait |
video:convert | Convert a video to a different format | --url · --format · --wait |
video:merge | Merge multiple videos into one | --urls · --wait |
video:remove-audio | Remove audio track from a video | --url · --wait |
video:reverse | Reverse a video | --url · --wait |
video:script-to-video | Generate a video from a script using AI | --title · --description · --keywords · --tone · --creativity-level · --language-code · --voice-id · --format · --no-runs · --logo-id · --caption-style-id · --should-export · --wait |
video:text-to-video | Generate a video from text using AI | --title · --description · --keywords · --tone · --creativity-level · --language-code · --voice-id · --format · --no-runs · --logo-id · --caption-style-id · --should-export · --wait |
video:speedup | Speed up or slow down a video | --url · --playbackrate · --wait |
video:task | Check the status of an async video processing task | --id |
Brand kits and context
| Command | What it does | Command-specific options |
|---|---|---|
brandkit:list | List brand kits in the workspace | --search |
brandkit:create | Create a brand kit (only —title is required) | --title · --description · --social-links · --json |
brandkit:get | Get a brand kit by id | --brand · --expand · --fields · --omit |
brandkit:brandbook | Get brand book data (optimized for AI/integrations) | --brand · --elements |
brandkit:build | Populate a brand kit with structured identity and visual style | --brand · --json · --data |
brandkit:import | Import brand kit modules (brand_voice, icps, usps, …) | --brand · --json · --data |
brandkit:context-list | List context documents linked to a brand kit | --brand · --canonical-key · --search · --ordering |
brandkit:context-create | Create or link a context document on a brand kit | --brand · --document-id · --doc-type · --name · --description · --content · --content-file · --data · --json |
brandkit:context-update | Update a linked context document | --brand · --link · --name · --description · --content · --content-file · --data · --json |
brandkit:context-delete | Delete a context document link from a brand kit | --brand · --link |
brandkit:context-get | Get a single context document by its link or document UUID | --brand · --link |
brandkit:context-get-by-type | Get a single context document by its canonical type | --brand · --type |
Projects and items
| Command | What it does | Command-specific options |
|---|---|---|
projects:list | List projects of the selected type | --type · --primary-type · --ordering · --search |
projects:create | Create a project of the selected type | --type · --title · --description · --primary-type · --data · --json |
projects:get | Get a project by id | --type · --id |
projects:delete | Soft-delete a project by id | --type · --id |
projects:export | Export project items to a partner integration | --type · --project · --partner-id · --item-ids |
projects:item-list | List items within a project | --type · --project · --primary-type · --ordering · --search |
projects:item-create | Create an item within a project | --type · --project · --title · --description · --primary-type · --data · --json · --start-date · --due-date · --status · --priority |
projects:item-get | Get a project item by id | --type · --project · --id |
projects:item-delete | Soft-delete a project item by id | --type · --project · --id |
projects:item-assign-agent | Assign an AI agent to a project item | --type · --project · --id · --agent-id |
projects:item-reorder | Move a project item to a new position | --type · --project · --id · --position |