> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.simplified.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.simplified.com/_mcp/server.

# Command reference

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.

```bash
simplified --help
simplified 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](/cli/use-from-an-ai-agent) for output handling.

## Authentication

[Step-by-step guide](/cli/install-and-authenticate)

| 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

[Step-by-step guide](/cli/teamspace-context)

| 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

[Step-by-step guide](/cli/social-publishing)

| Command         | What it does                         | Command-specific options |
| --------------- | ------------------------------------ | ------------------------ |
| `accounts:list` | List connected social media accounts | `--network`              |

## Posts and drafts

[Step-by-step guide](/cli/social-publishing)

| 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

[Step-by-step guide](/cli/reviews-and-approvals)

| 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

[Step-by-step guide](/cli/analytics-and-reporting)

| 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

[Step-by-step guide](/cli/assets-and-uploads)

| 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

[Step-by-step guide](/cli/ai-image-generation)

| 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

[Step-by-step guide](/cli/ai-video-generation)

| 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

[Step-by-step guide](/cli/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

[Step-by-step guide](/cli/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

[Step-by-step guide](/cli/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

[Step-by-step guide](/cli/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`                                                                                                            |