# Complete reference (/cli/reference) Every command on one page, generated from the CLI itself. Start at the [overview](/cli/commands) to browse; this page is for searching and for tools. Append `.mdx` to any page for its raw Markdown — [`/cli/reference.mdx`](/cli/reference.mdx) is this page as plain text. The docs are also published as [`/llms.txt`](/llms.txt) and [`/llms-full.txt`](/llms-full.txt). ## Global options [#global-options] These apply to every command, and may be written before or after it. | Option | Description | | ---------------------- | --------------------------------------------------------------------------------- | | `-P, --profile ` | Profile to use (env: SIM\_PROFILE). | | `--endpoint ` | Sim deployment to talk to (env: SIM\_ENDPOINT). | | `-w, --workspace ` | Workspace to target (env: SIM\_WORKSPACE). | | `--output ` | Output format for this command. Accepted values: `table`, `json`, `yaml`, `text`. | ## sim login [#sim-login] Sign in through the browser and store the login for the profile ```bash sim login [options] ``` **Options** | Option | Required | Description | | ------------------------ | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--method ` | No | Credential to obtain: oauth requires OAuth support; api-key creates a permanent key through pairing (auto-selects when omitted). Accepted values: `oauth`, `api-key`. | | `--no-browser` | No | Print the approval URL without opening it (either login method). | | `--read-only` | No | Ask only for permission to read, never to change anything. | | `--callback-port ` | No | Pin the local port the browser returns to. | | `-y, --yes` | No | Overwrite an existing API-key profile without prompting. | ## sim logout [#sim-logout] Sign out and remove the profile's stored login ```bash sim logout [options] ``` **Options** | Option | Required | Description | | ------- | -------- | ---------------------------------------------------- | | `--all` | No | Remove the profile entirely, including its settings. | ## sim whoami [#sim-whoami] Show the resolved profile, where each setting came from, and whether it works ```bash sim whoami [options] ``` **Options** | Option | Required | Description | | ------------- | -------- | -------------------------------------------------------- | | `--no-verify` | No | Skip the API check and only print the resolved settings. | ## sim configure [#sim-configure] Set a profile's endpoint, default workspace, or output format ```bash sim configure [options] ``` **Options** | Option | Required | Description | | ----------------------- | -------- | ------------------------------------------------------ | | `--set-endpoint ` | No | Sim deployment to talk to. | | `--set-workspace ` | No | Default workspace for workspace-scoped commands. | | `--set-output ` | No | Default output format (table \| json \| yaml \| text). | | `--unset ` | No | Remove settings (endpoint, workspace, output). | ## sim chat [#sim-chat] Ask Sim and print the reply ```bash sim chat [options] ``` **Arguments** | Argument | Required | Description | | --------- | -------- | --------------- | | `message` | Yes | What to ask Sim | **Options** | Option | Required | Description | | ------------------------- | -------- | --------------------------------------- | | `-c, --conversation ` | No | Continue the conversation with this ID. | ## sim profiles [#sim-profiles] Also spelled `sim profile`. ### sim profiles list [#sim-profiles-list] List configured profiles ```bash sim profiles list ``` ### sim profiles add [#sim-profiles-add] Add a workspace profile that shares the active stored login ```bash sim profiles add [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ------------------------ | | `name` | Yes | Name for the new profile | **Options** | Option | Required | Description | | ---------------------- | -------- | ---------------------------------------------------------- | | `-w, --workspace ` | No | Existing workspace to use; omit for an interactive picker. | ## sim audit-logs [#sim-audit-logs] Also spelled `sim audit-log`. ### sim audit-logs get [#sim-audit-logs-get] Get Audit Log (OAuth login or personal API key required) ```bash sim audit-logs get [options] ``` **Arguments** | Argument | Required | Description | | ------------ | -------- | --------------------------- | | `auditLogId` | Yes | Audit-log entry identifier. | **Options** | Option | Required | Description | | ------------------------ | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--organization ` | No | Organization ID; defaults to your only organization, and is required when your account belongs to more than one (OAuth login or personal API key required). | ### sim audit-logs list [#sim-audit-logs-list] List Audit Logs (OAuth login or personal API key required) ```bash sim audit-logs list [options] ``` **Options** | Option | Required | Description | | ------------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--action ` | No | Filter by exact action name. | | `--resource-type ` | No | Filter by resource type. Accepts a comma-separated set; members are trimmed and deduplicated, and member order affects neither the result nor the cursor. | | `--resource-id ` | No | Filter by exact resource identifier. | | `--start-date ` | No | Only include runs started at or after this UTC ISO 8601 timestamp, e.g. `2026-08-06T00:00:00Z`. A date without a time, or a timestamp carrying a UTC offset instead of `Z`, is rejected, as is year `0000`, which names no storable instant. | | `--end-date ` | No | Only include runs started at or before this UTC ISO 8601 timestamp, e.g. `2026-08-06T00:00:00Z`. A date without a time, or a timestamp carrying a UTC offset instead of `Z`, is rejected, as is year `0000`, which names no storable instant. | | `--include-departed` | No | Include actions by users who have left the organization. | | `--no-include-departed` | No | Send --include-departed as false. | | `--limit ` | No | Maximum items to return (0 for everything). Defaults to `100`. | | `--cursor ` | No | Continue from nextCursor returned by a previous result. | | `--organization ` | No | Organization ID; defaults to your only organization, and is required when your account belongs to more than one (OAuth login or personal API key required). | | `--actor-email ` | No | Filter by actor email address. | | `--all-workspaces` | No | Do not filter to the configured workspace (OAuth login or personal API key required for account-wide access). | ## sim billing [#sim-billing] ### sim billing status [#sim-billing-status] Show billing status and current-period credit usage (credits and storage require an OAuth login or personal API key) ```bash sim billing status [options] ``` **Options** | Option | Required | Description | | ------------------ | -------- | ------------------------------------------------------------------------------------------------------------- | | `--all-workspaces` | No | Do not filter to the configured workspace (OAuth login or personal API key required for account-wide access). | ### sim billing logs [#sim-billing-logs] List credit usage events (an OAuth login or personal API key reports only your events; a workspace API key reports every member's in aggregate, unattributed) ```bash sim billing logs [options] ``` **Options** | Option | Required | Description | | ---------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `--source ` | No | Filter by usage source; sim-chat combines Copilot and workspace chat. Accepted values: `workflow`, `wand`, `sim-chat`, `mcp_copilot`, `mothership_block`, `knowledge-base`, `voice-input`, `enrichment`, `voice-output`, `api-tool`. | | `--period ` | No | Billing period. Accepted values: `1d`, `7d`, `30d`, `all`, `custom`. | | `--start-date ` | No | Custom period start (ISO 8601). | | `--end-date ` | No | Custom period end (ISO 8601). | | `--limit ` | No | Maximum items to return (0 for everything). Defaults to `100`. | | `--cursor ` | No | Continue from nextCursor returned by a previous result. | | `--all-workspaces` | No | Do not filter to the configured workspace (OAuth login or personal API key required for account-wide access). | ## sim blocks [#sim-blocks] ### sim blocks get [#sim-blocks-get] Get Block ```bash sim blocks get ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------------------------------------------------------------------------------------------------------ | | `blockId` | Yes | Block type identifier. An unversioned base type resolves to the newest version, and the response echoes the resolved id. | ### sim blocks list [#sim-blocks-list] List Blocks ```bash sim blocks list [options] ``` **Options** | Option | Required | Description | | ---------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--search ` | No | Case-insensitive substring match against the block id, name, and description. | | `--category ` | No | Restrict to one toolbar category. Accepted values: `blocks`, `tools`, `triggers`. | | `--capability ` | No | Restrict to blocks that can start a workflow — the `triggers` category, blocks declaring `triggerAllowed`, and blocks with trigger-mode fields. Accepted values: `trigger`. | | `--source ` | No | Restrict to built-in blocks or this workspace's deployed custom blocks. Accepted values: `builtin`, `custom`. | | `--sort-by ` | No | Field used to sort the result. Sorting by `name` is case-sensitive and follows the storage collation, so do not rely on a case-insensitive order. Accepted values: `id`, `name`, `category`. | | `--sort-order ` | No | Sort direction. Accepted values: `asc`, `desc`. | | `--limit ` | No | Maximum items to return (0 for everything). Defaults to `0`. | ## sim chat-deployments [#sim-chat-deployments] ### sim chat-deployments list [#sim-chat-deployments-list] List Chat Deployments ```bash sim chat-deployments list [options] ``` **Options** | Option | Required | Description | | ----------------------- | -------- | --------------------------------------------------------------------------------------- | | `--workflow-id ` | No | Restrict to deployments of one workflow. | | `--is-active` | No | Restrict to active or inactive deployments. | | `--no-is-active` | No | Send --is-active as false. | | `--sort-by ` | No | Field used to sort the result. Accepted values: `identifier`, `createdAt`, `updatedAt`. | | `--sort-order ` | No | Sort direction. Accepted values: `asc`, `desc`. | | `--limit ` | No | Maximum items to return (0 for everything). Defaults to `0`. | ## sim connector-types [#sim-connector-types] ### sim connector-types list [#sim-connector-types-list] List Connector Types ```bash sim connector-types list [options] ``` **Options** | Option | Required | Description | | ------------------ | -------- | ------------------------------------------------------------ | | `--search ` | No | Case-insensitive substring match against the connector name. | ## sim credentials [#sim-credentials] Also spelled `sim credential`. ### sim credentials delete [#sim-credentials-delete] Disconnect Credential (OAuth login or personal API key required) ```bash sim credentials delete [options] ``` **Arguments** | Argument | Required | Description | | -------------- | -------- | ------------------------- | | `credentialId` | Yes | Credential to disconnect. | **Options** | Option | Required | Description | | ----------- | -------- | ----------------------- | | `-y, --yes` | Yes | Confirm this operation. | ### sim credentials providers list [#sim-credentials-providers-list] List Credential Providers ```bash sim credentials providers list [options] ``` **Options** | Option | Required | Description | | ------------------ | -------- | ---------------------------------------------------------------------- | | `--search ` | No | Case-insensitive substring match against the credential provider name. | ### sim credentials list [#sim-credentials-list] List Credentials ```bash sim credentials list [options] ``` **Options** | Option | Required | Description | | ----------------------- | -------- | ---------------------------------------------------------------------------------------- | | `--type ` | No | Restrict results to this credential type. Accepted values: `oauth`, `service_account`. | | `--provider-id ` | No | Restrict results to credentials for this integration provider. | | `--search ` | No | Case-insensitive substring match against the credential display name. | | `--sort-by ` | No | Field used to sort the result. Accepted values: `displayName`, `createdAt`, `updatedAt`. | | `--sort-order ` | No | Sort direction. Accepted values: `asc`, `desc`. | | `--limit ` | No | Maximum items to return (0 for everything). Defaults to `0`. | ### sim credentials update [#sim-credentials-update] Update Credential (OAuth login or personal API key required) ```bash sim credentials update [options] ``` **Arguments** | Argument | Required | Description | | -------------- | -------- | --------------------- | | `credentialId` | Yes | Credential to update. | **Options** | Option | Required | Description | | -------------------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------- | | `--display-name ` | No | New name shown for the credential in Sim. | | `--description ` | No | New credential description. Send null to clear the stored one. (--description null sends the word, not JSON null). | | `--service-account-json ` | No | Write-only Google service-account JSON key. | | `--api-token ` | No | Write-only provider API token. | | `--domain ` | No | Provider account domain. | | `--atlassian-product ` | No | Atlassian product to verify; defaults to Jira on create and preserves the saved product on reconnect. Accepted values: `jira`, `confluence`. | | `--signing-secret ` | No | Write-only webhook signing secret. | | `--bot-token ` | No | Write-only bot token. | | `--client-id ` | No | OAuth client identifier. | | `--client-secret ` | No | Write-only OAuth client secret. | | `--certificate-id ` | No | Provider certificate mapping identifier. | | `--org-id ` | No | Provider organization ID. | | `--data-center ` | No | Provider data center. | | `--auth-method ` | No | Provider authentication method. | | `--private-key ` | No | Write-only PEM private key. | | `--username ` | No | Provider run-as username. | | `--name ` | No | Alias for --display-name. | ### sim credentials create [#sim-credentials-create] Create a service-account credential using its discovered provider schema (OAuth login or personal API key required) ```bash sim credentials create [options] ``` **Arguments** | Argument | Required | Description | | ------------ | -------- | --------------------------------------------------- | | `providerId` | Yes | Service-account provider to create a credential for | **Options** | Option | Required | Description | | ----------------------------- | -------- | --------------------------------------------------------------------- | | `--name ` | Yes | Name shown for the credential in Sim. | | `--credentials ` | Yes | Provider credentials as JSON (or @path / @- to read a file or stdin). | | `--description ` | No | Optional credential description. | | `--id ` | No | Client-generated credential ID when provider discovery requires it. | ### sim credentials connect [#sim-credentials-connect] Create a short-lived link for connecting an OAuth provider (OAuth login or personal API key required) ```bash sim credentials connect [options] ``` **Arguments** | Argument | Required | Description | | ------------ | -------- | ------------------------- | | `providerId` | Yes | OAuth provider to connect | **Options** | Option | Required | Description | | ---------------------- | -------- | ----------------------------------------- | | `--name ` | Yes | Name shown for the new credential in Sim. | ### sim credentials reconnect [#sim-credentials-reconnect] Create a short-lived link for reconnecting an OAuth credential (OAuth login or personal API key required) ```bash sim credentials reconnect ``` **Arguments** | Argument | Required | Description | | -------------- | -------- | ----------------------------------------- | | `credentialId` | Yes | Existing OAuth credential to re-authorize | ## sim custom-tools [#sim-custom-tools] Also spelled `sim custom-tool`. ### sim custom-tools create [#sim-custom-tools-create] Create Custom Tool ```bash sim custom-tools create [options] ``` **Options** | Option | Required | Description | | ------------------------ | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--title ` | Yes | Display title, unique within the workspace. | | `--schema ` | Yes | OpenAI function schema: \{"type":"function","function":\{"name":"...","parameters":\{"type":"object","properties":\{}}}} (JSON, or @path / @- to read a file or stdin). | | `--code ` | Yes | Tool implementation executed in the sandboxed function runtime. | ### sim custom-tools delete [#sim-custom-tools-delete] Delete Custom Tool ```bash sim custom-tools delete [options] ``` **Arguments** | Argument | Required | Description | | -------------- | -------- | ------------------------------ | | `customToolId` | Yes | Unique custom tool identifier. | **Options** | Option | Required | Description | | ----------- | -------- | ----------------------- | | `-y, --yes` | Yes | Confirm this operation. | ### sim custom-tools get [#sim-custom-tools-get] Get Custom Tool ```bash sim custom-tools get ``` **Arguments** | Argument | Required | Description | | -------------- | -------- | ------------------------------ | | `customToolId` | Yes | Unique custom tool identifier. | ### sim custom-tools list [#sim-custom-tools-list] List Custom Tools ```bash sim custom-tools list [options] ``` **Options** | Option | Required | Description | | ---------------------- | -------- | ---------------------------------------------------------------------------------- | | `--search ` | No | Case-insensitive substring match against the tool title. | | `--sort-by ` | No | Field used to sort the result. Accepted values: `title`, `createdAt`, `updatedAt`. | | `--sort-order ` | No | Sort direction. Accepted values: `asc`, `desc`. | | `--limit ` | No | Maximum items to return (0 for everything). Defaults to `0`. | ### sim custom-tools update [#sim-custom-tools-update] Update Custom Tool ```bash sim custom-tools update [options] ``` **Arguments** | Argument | Required | Description | | -------------- | -------- | ------------------------------ | | `customToolId` | Yes | Unique custom tool identifier. | **Options** | Option | Required | Description | | ------------------------ | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--title ` | No | New display title for the tool. | | `--schema ` | No | OpenAI function schema: \{"type":"function","function":\{"name":"...","parameters":\{"type":"object","properties":\{}}}} (JSON, or @path / @- to read a file or stdin). | | `--code ` | No | Replacement tool implementation. | ## sim files [#sim-files] Also spelled `sim file`. ### sim files batch-delete [#sim-files-batch-delete] Delete several files at once ```bash sim files batch-delete [options] ``` **Options** | Option | Required | Description | | ----------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------- | | `--file-ids ` | Yes | File identifiers to update. (space-separated, or @path / @- with one value per line; @@value for a literal leading @). | | `-y, --yes` | Yes | Confirm this operation. | ### sim files create [#sim-files-create] Create File ```bash sim files create [options] ``` **Options** | Option | Required | Description | | ------------------------ | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--name ` | Yes | File name, including its extension. Path separators and dot segments are rejected. | | `--content-type ` | No | MIME type. When omitted, it is inferred from the file extension. | | `--folder ` | No | Folder path as shown in the app; the leading / is optional. | | `--content ` | No | Initial file content. Omit or send an empty string for a zero-byte file. The 70,000,000-character bound guards the JSON envelope; the decoded bytes must be at most 50 MiB, and a longer base64 payload is rejected with `413`. Use an upload session for anything larger. | | `--encoding ` | No | Encoding of the content field. Accepted values: `utf-8`, `base64`. | ### sim files folders create [#sim-files-folders-create] Create a file folder at a path ```bash sim files folders create ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ---------------------------------------------------------- | | `path` | Yes | Folder path as shown in the app; the leading / is optional | ### sim files folders delete [#sim-files-folders-delete] Delete Folder ```bash sim files folders delete [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ---------------------------------------------------------- | | `path` | Yes | Folder path as shown in the app; the leading / is optional | **Options** | Option | Required | Description | | ------------- | -------- | -------------------------------------- | | `--recursive` | No | Delete the folder and its descendants. | | `-y, --yes` | Yes | Confirm this operation. | ### sim files folders list [#sim-files-folders-list] List folders ```bash sim files folders list [options] ``` Also available as `sim files folders ls`. **Options** | Option | Required | Description | | ---------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `--parent ` | No | Direct parent folder path. | | `--search ` | No | Case-insensitive substring match against the folder name. | | `--sort-by ` | No | Field used to sort the result. Sorting by `name` is case-sensitive and follows the storage collation, so do not rely on a case-insensitive order. Accepted values: `name`, `createdAt`, `updatedAt`. | | `--sort-order ` | No | Sort direction. Accepted values: `asc`, `desc`. | | `--scope ` | No | Which lifecycle set to list: `active` (default) returns live folders only; `archived` returns folders a recursive delete soft-deleted, which is how a caller finds a path to hand to the folder restore. Authorization is identical for both. Accepted values: `active`, `archived`. | | `--recursive ` | No | Whether parentPath includes every descendant instead of direct children only. Accepted values: `true`, `1`, `yes`, `on`, `y`, `enabled`, `false`, `0`, `no`, `off`, `n`, `disabled`. | | `--depth ` | No | Deepest level below parentPath to include when recursive is true. | ### sim files folders move [#sim-files-folders-move] Rename or move a file folder ```bash sim files folders move ``` Also available as `sim files folders mv`. **Arguments** | Argument | Required | Description | | ------------- | -------- | ---------------------------------------------------------- | | `path` | Yes | Folder path as shown in the app; the leading / is optional | | `destination` | Yes | Folder path as shown in the app; the leading / is optional | ### sim files folders restore [#sim-files-folders-restore] Restore an archived file folder ```bash sim files folders restore ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ---------------------------------------------------------- | | `path` | Yes | Folder path as shown in the app; the leading / is optional | ### sim files delete [#sim-files-delete] Delete File ```bash sim files delete [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ---------------- | | `fileId` | Yes | File identifier. | **Options** | Option | Required | Description | | ----------- | -------- | ----------------------- | | `-y, --yes` | Yes | Confirm this operation. | ### sim files edit [#sim-files-edit] Apply one exact or anchor-based edit to a text file ```bash sim files edit [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ---------------- | | `fileId` | Yes | File identifier. | **Options** | Option | Required | Description | | ---------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `--edit ` | Yes | One edit object: \{"mode":"search\_replace","search":"old","content":"new","replaceAll":false}, \{"mode":"replace\_between","beforeAnchor":"start line","afterAnchor":"end line","content":"new"}, \{"mode":"insert\_after","anchor":"line","content":"new"}, or \{"mode":"delete\_between","startAnchor":"first line deleted","endAnchor":"ending line kept"}. Anchored modes also accept occurrence starting at 1 (JSON, or @path / @- to read a file or stdin). | ### sim files describe [#sim-files-describe] Show file metadata and sharing status ```bash sim files describe [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ---------------- | | `fileId` | Yes | File identifier. | **Options** | Option | Required | Description | | ----------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `--scope ` | No | Which lifecycle set to read from: `active` (default) resolves live files only and returns `404` for a file a delete soft-deleted; `archived` also resolves soft-deleted files, so metadata stays readable before the file is restored. Authorization is identical for both. Accepted values: `active`, `archived`. | ### sim files share get [#sim-files-share-get] Show a file’s share settings ```bash sim files share get ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ---------------- | | `fileId` | Yes | File identifier. | ### sim files share set [#sim-files-share-set] Enable or disable sharing for a file (OAuth login or personal API key required) ```bash sim files share set [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ---------------- | | `fileId` | Yes | File identifier. | **Options** | Option | Required | Description | | ----------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--is-active ` | Yes | Whether the share should resolve. Disabling preserves the token and the whole access configuration, so re-enabling restores the share as it was; enabling rewrites the credentials the resulting mode does not use. Accepted values: `true`, `false`. | | `--auth-type ` | No | How access to the share is gated. The stored mode is kept when omitted. Enabling `public` clears the stored password and empties `allowedEmails`; `password` empties `allowedEmails`; `email` and `sso` clear the stored password. Accepted values: `public`, `password`, `email`, `sso`. | | `--password ` | No | Password for a password-gated share. Kept when omitted; enabling `password` with neither a supplied nor a stored password is a 400. | | `--allowed-emails ` | No | Allowed addresses or `@domain` patterns for email and SSO shares. Kept when omitted; enabling `email` or `sso` with an empty resulting list is a 400. (space-separated, or @path / @- with one value per line; @@value for a literal leading @). | ### sim files list [#sim-files-list] List Files ```bash sim files list [options] ``` **Options** | Option | Required | Description | | ---------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `--folder ` | No | Folder path as shown in the app; the leading / is optional. | | `--recursive` | No | Include subfolders in the folder filter. Defaults to true when searching and false otherwise. Ignored without a folder filter. | | `--no-recursive` | No | Send --recursive as false. | | `--scope ` | No | Which lifecycle set to list: `active` (default) for live files, `archived` for files a delete soft-deleted. `folderPath` resolves against active folders only, so pairing it with `scope=archived` returns an empty page when the containing folder was archived too. Accepted values: `active`, `archived`. | | `--search ` | No | Case-insensitive substring match against the file name. | | `--sort-by ` | No | Field used to sort the result. Sorting by `name` is case-sensitive and follows the storage collation, so do not rely on a case-insensitive order. Accepted values: `name`, `size`, `uploadedAt`, `updatedAt`. | | `--sort-order ` | No | Sort direction. Accepted values: `asc`, `desc`. | | `--limit ` | No | Maximum items to return (0 for everything). Defaults to `0`. | ### sim files move [#sim-files-move] Move files into another folder ```bash sim files move [options] ``` Also available as `sim files mv`. **Options** | Option | Required | Description | | ----------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------- | | `--file-ids ` | Yes | File identifiers to update. (space-separated, or @path / @- with one value per line; @@value for a literal leading @). | | `--to ` | No | Destination folder path; omit for root. | ### sim files read [#sim-files-read] Read a file’s text content ```bash sim files read [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ---------------- | | `fileId` | Yes | File identifier. | **Options** | Option | Required | Description | | --------------------- | -------- | ---------------------------------------------------------------------------------------------------- | | `--max-bytes ` | No | Optional ceiling on the source bytes fed to the parser, lowering but never raising the server limit. | | `--offset ` | No | First line to return, 1-based. Absent starts at the first line. | | `--limit ` | No | How many lines to return from `offset`. Absent reads to the end. | ### sim files rename [#sim-files-rename] Rename a file ```bash sim files rename [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ---------------- | | `fileId` | Yes | File identifier. | **Options** | Option | Required | Description | | ---------------- | -------- | --------------------------------------- | | `--name ` | Yes | New file name, including its extension. | ### sim files restore [#sim-files-restore] Restore an archived file ```bash sim files restore ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ---------------- | | `fileId` | Yes | File identifier. | ### sim files search [#sim-files-search] Search File Content ```bash sim files search [options] ``` **Options** | Option | Required | Description | | ------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--query ` | Yes | Regular expression, or exact text when `mode` is `exact`. | | `--mode ` | No | How `query` is read. Accepted values: `exact`, `regex`. | | `--max-results ` | No | Maximum matching lines to return. | | `--folder ` | No | Folders to search, by path as shown in the app; omit to search the whole workspace (space-separated, or @path / @- with one value per line; @@value for a literal leading @). | | `--include-subfolders` | No | Whether each folder scope includes nested folders; on by default. | | `--no-include-subfolders` | No | Send --include-subfolders as false. | ### sim files unzip [#sim-files-unzip] Unzip an archive into a new folder beside it ```bash sim files unzip [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ---------------- | | `fileId` | Yes | File identifier. | **Options** | Option | Required | Description | | ----------- | -------- | ----------------------- | | `-y, --yes` | Yes | Confirm this operation. | ### sim files set-content [#sim-files-set-content] Replace a file’s contents ```bash sim files set-content [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ---------------- | | `fileId` | Yes | File identifier. | **Options** | Option | Required | Description | | -------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--content ` | Yes | Complete replacement content for the file. The 70,000,000-character bound guards the JSON envelope; the decoded bytes must be at most 50 MiB, and a longer base64 payload is rejected with `413`. | | `--encoding ` | No | Content encoding. Accepted values: `utf-8`, `base64`. | ### sim files upload [#sim-files-upload] Upload a file to the workspace ```bash sim files upload [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | -------------------- | | `path` | Yes | Local file to upload | **Options** | Option | Required | Description | | ----------------- | -------- | ------------------------------------------------------------- | | `--folder ` | No | Folder path as shown in the app; defaults to the root folder. | | `--name ` | No | Store it under a different name. | ### sim files get [#sim-files-get] Get a file’s content ```bash sim files get [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | -------------------------- | | `fileId` | Yes | File whose content to read | **Options** | Option | Required | Description | | -------------------------- | -------- | --------------------------------------------- | | `-o, --output-file ` | No | Write content to a file instead of stdout. | | `--force` | No | Overwrite --output-file if it already exists. | ### sim files ls [#sim-files-ls] List file resources and child folders together ```bash sim files ls [path] [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ------------------------------------------------ | | `path` | No | Folder path to list; defaults to the root folder | **Options** | Option | Required | Description | | ----------------- | -------- | --------------------------------------------------------------------- | | `--search ` | No | Filter folders and resources by name. | | `--limit ` | No | Maximum combined items to return (0 for everything). Defaults to `0`. | ### sim files mkdir [#sim-files-mkdir] Create a file directory at a path ```bash sim files mkdir ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ------------------------------------------------ | | `path` | Yes | Folder path to create; the leading / is optional | ## sim knowledge [#sim-knowledge] Also spelled `sim kb`. ### sim knowledge from-workspace-files create [#sim-knowledge-from-workspace-files-create] Index files the workspace already stores (OAuth login or personal API key required) ```bash sim knowledge from-workspace-files create [options] ``` **Arguments** | Argument | Required | Description | | ----------------- | -------- | --------------------------------- | | `knowledgeBaseId` | Yes | Unique knowledge base identifier. | **Options** | Option | Required | Description | | ------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------- | | `--file ` | Yes | Workspace file ID or key (repeatable) (space-separated, or @path / @- with one value per line; @@value for a literal leading @). | ### sim knowledge tags save [#sim-knowledge-tags-save] Declare the tag definitions a knowledge base needs (OAuth login or personal API key required) ```bash sim knowledge tags save [options] ``` **Arguments** | Argument | Required | Description | | ----------------- | -------- | --------------------------------- | | `knowledgeBaseId` | Yes | Unique knowledge base identifier. | **Options** | Option | Required | Description | | ----------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------- | | `--definitions ` | Yes | Tag definitions: \[\{"tagSlot":"tag1","displayName":"category","fieldType":"text"}] (JSON, or @path / @- to read a file or stdin). | ### sim knowledge tags create [#sim-knowledge-tags-create] Create Tag (OAuth login or personal API key required) ```bash sim knowledge tags create [options] ``` **Arguments** | Argument | Required | Description | | ----------------- | -------- | --------------------------------- | | `knowledgeBaseId` | Yes | Unique knowledge base identifier. | **Options** | Option | Required | Description | | ------------------------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `--display-name ` | Yes | Name tag filters and document reads use for this tag. | | `--field-type ` | No | Value type stored in the slot; it decides which slots are usable and which filter operators apply. Defaults to text, so a number, date, or boolean slot must name its type here. Slot capacity per type: text 7, number 5, date 2, boolean 3. Accepted values: `text`, `number`, `date`, `boolean`. | | `--tag-slot ` | No | Slot to store the tag in. Omit to take the next free slot for the field type; a slot that does not belong to the field type, or one already in use, is rejected. Accepted values: `tag1`, `tag2`, `tag3`, `tag4`, `tag5`, `tag6`, `tag7`, `number1`, `number2`, `number3`, `number4`, `number5`, `date1`, `date2`, `boolean1`, `boolean2`, `boolean3`. | ### sim knowledge tags delete [#sim-knowledge-tags-delete] Delete Tag (OAuth login or personal API key required) ```bash sim knowledge tags delete [options] ``` **Arguments** | Argument | Required | Description | | ----------------- | -------- | --------------------------------- | | `knowledgeBaseId` | Yes | Unique knowledge base identifier. | | `tagId` | Yes | Unique tag definition identifier. | **Options** | Option | Required | Description | | ----------- | -------- | ----------------------- | | `-y, --yes` | Yes | Confirm this operation. | ### sim knowledge tags cleanup [#sim-knowledge-tags-cleanup] Remove tag definitions no document still uses (OAuth login or personal API key required) ```bash sim knowledge tags cleanup [options] ``` **Arguments** | Argument | Required | Description | | ----------------- | -------- | --------------------------------- | | `knowledgeBaseId` | Yes | Unique knowledge base identifier. | **Options** | Option | Required | Description | | ------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--unused` | No | Whether to remove only the tag definitions no document in the knowledge base still carries a value for. Defaults to true. Pass --no-unused to delete every definition on the knowledge base, which also clears its slot on every document and chunk and is not recoverable. | | `--no-unused` | No | Send --unused as false. | | `-y, --yes` | Yes | Confirm this operation. | ### sim knowledge tags next-slot [#sim-knowledge-tags-next-slot] Show which tag slot a create would take for a field type (OAuth login or personal API key required) ```bash sim knowledge tags next-slot [options] ``` **Arguments** | Argument | Required | Description | | ----------------- | -------- | --------------------------------- | | `knowledgeBaseId` | Yes | Unique knowledge base identifier. | **Options** | Option | Required | Description | | ---------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--field-type ` | Yes | Value type stored in the slot; it decides which slots are usable and which filter operators apply. Slot capacity per type: text 7, number 5, date 2, boolean 3. Accepted values: `text`, `number`, `date`, `boolean`. | ### sim knowledge tags list [#sim-knowledge-tags-list] List Tags ```bash sim knowledge tags list ``` **Arguments** | Argument | Required | Description | | ----------------- | -------- | --------------------------------- | | `knowledgeBaseId` | Yes | Unique knowledge base identifier. | ### sim knowledge tags usage [#sim-knowledge-tags-usage] Show how many documents and chunks carry each tag (OAuth login or personal API key required) ```bash sim knowledge tags usage ``` **Arguments** | Argument | Required | Description | | ----------------- | -------- | --------------------------------- | | `knowledgeBaseId` | Yes | Unique knowledge base identifier. | ### sim knowledge tags update [#sim-knowledge-tags-update] Update Tag (OAuth login or personal API key required) ```bash sim knowledge tags update [options] ``` **Arguments** | Argument | Required | Description | | ----------------- | -------- | --------------------------------- | | `knowledgeBaseId` | Yes | Unique knowledge base identifier. | | `tagId` | Yes | Unique tag definition identifier. | **Options** | Option | Required | Description | | ------------------------ | -------- | --------------------------------------------------------------------------------- | | `--display-name ` | No | New tag display name. | | `--field-type ` | No | New value type for the tag. Accepted values: `text`, `number`, `date`, `boolean`. | ### sim knowledge chunks batch-update [#sim-knowledge-chunks-batch-update] Enable, disable, or delete many chunks at once (OAuth login or personal API key required) ```bash sim knowledge chunks batch-update [options] ``` **Arguments** | Argument | Required | Description | | ----------------- | -------- | ------------------------------------- | | `knowledgeBaseId` | Yes | Unique knowledge base identifier. | | `documentId` | Yes | Unique knowledge document identifier. | **Options** | Option | Required | Description | | --------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--operation ` | Yes | What to do with the selected chunks. Accepted values: `enable`, `disable`, `delete`. | | `--chunk ` | Yes | Chunks to operate on, by identifier. An id naming no chunk in the document is reported in errors and does not fail the request. (space-separated, or @path / @- with one value per line; @@value for a literal leading @). | | `-y, --yes` | Yes | Confirm this operation. | ### sim knowledge chunks create [#sim-knowledge-chunks-create] Create Chunk (OAuth login or personal API key required) ```bash sim knowledge chunks create [options] ``` **Arguments** | Argument | Required | Description | | ----------------- | -------- | ------------------------------------- | | `knowledgeBaseId` | Yes | Unique knowledge base identifier. | | `documentId` | Yes | Unique knowledge document identifier. | **Options** | Option | Required | Description | | ------------------- | -------- | ------------------------------------------------------------------------------- | | `--content ` | Yes | Text to embed. It is embedded on write, so the chunk is searchable immediately. | | `--enabled` | No | Whether the new chunk participates in search. | | `--no-enabled` | No | Send --enabled as false. | ### sim knowledge chunks delete [#sim-knowledge-chunks-delete] Delete Chunk (OAuth login or personal API key required) ```bash sim knowledge chunks delete [options] ``` **Arguments** | Argument | Required | Description | | ----------------- | -------- | ------------------------------------- | | `knowledgeBaseId` | Yes | Unique knowledge base identifier. | | `documentId` | Yes | Unique knowledge document identifier. | | `chunkId` | Yes | Unique chunk identifier. | **Options** | Option | Required | Description | | ----------- | -------- | ----------------------- | | `-y, --yes` | Yes | Confirm this operation. | ### sim knowledge chunks get [#sim-knowledge-chunks-get] Get Chunk (OAuth login or personal API key required) ```bash sim knowledge chunks get ``` **Arguments** | Argument | Required | Description | | ----------------- | -------- | ------------------------------------- | | `knowledgeBaseId` | Yes | Unique knowledge base identifier. | | `documentId` | Yes | Unique knowledge document identifier. | | `chunkId` | Yes | Unique chunk identifier. | ### sim knowledge chunks list [#sim-knowledge-chunks-list] List Chunks (OAuth login or personal API key required) ```bash sim knowledge chunks list [options] ``` **Arguments** | Argument | Required | Description | | ----------------- | -------- | ------------------------------------- | | `knowledgeBaseId` | Yes | Unique knowledge base identifier. | | `documentId` | Yes | Unique knowledge document identifier. | **Options** | Option | Required | Description | | ---------------------- | -------- | ---------------------------------------------------------------------------------------------------- | | `--search ` | No | Case-insensitive substring match against chunk content. | | `--enabled ` | No | Restrict to enabled or disabled chunks. `all` returns both. Accepted values: `true`, `false`, `all`. | | `--sort-by ` | No | Field used to sort the result. Accepted values: `chunkIndex`, `tokenCount`, `enabled`. | | `--sort-order ` | No | Sort direction. Accepted values: `asc`, `desc`. | | `--limit ` | No | Maximum items to return (0 for everything). Defaults to `100`. | | `--cursor ` | No | Continue from nextCursor returned by a previous result. | ### sim knowledge chunks update [#sim-knowledge-chunks-update] Update Chunk (OAuth login or personal API key required) ```bash sim knowledge chunks update [options] ``` **Arguments** | Argument | Required | Description | | ----------------- | -------- | ------------------------------------- | | `knowledgeBaseId` | Yes | Unique knowledge base identifier. | | `documentId` | Yes | Unique knowledge document identifier. | | `chunkId` | Yes | Unique chunk identifier. | **Options** | Option | Required | Description | | ------------------- | -------- | ------------------------------------------------------------------------------------------------ | | `--content ` | No | Replacement text. Changing it re-embeds the chunk and re-derives its token and character counts. | | `--enabled` | No | Whether the chunk participates in search. Disabling keeps it indexed. | | `--no-enabled` | No | Send --enabled as false. | ### sim knowledge documents batch-update [#sim-knowledge-documents-batch-update] Enable or disable every matching document (OAuth login or personal API key required) ```bash sim knowledge documents batch-update [options] ``` **Arguments** | Argument | Required | Description | | ----------------- | -------- | --------------------------------- | | `knowledgeBaseId` | Yes | Unique knowledge base identifier. | **Options** | Option | Required | Description | | -------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------ | | `--operation ` | Yes | Whether the selected documents become enabled or disabled for search. Accepted values: `enable`, `disable`. | | `--document ` | No | Documents to update, by identifier. (space-separated, or @path / @- with one value per line; @@value for a literal leading @). | | `--select-all` | No | Apply to every document in the knowledge base. | | `--enabled-filter ` | No | With `selectAll`, restrict the update to documents in this state. Accepted values: `all`, `enabled`, `disabled`. | ### sim knowledge documents delete [#sim-knowledge-documents-delete] Delete Document ```bash sim knowledge documents delete [options] ``` **Arguments** | Argument | Required | Description | | ----------------- | -------- | ------------------------------------- | | `knowledgeBaseId` | Yes | Unique knowledge base identifier. | | `documentId` | Yes | Unique knowledge document identifier. | **Options** | Option | Required | Description | | ----------- | -------- | ----------------------- | | `-y, --yes` | Yes | Confirm this operation. | ### sim knowledge documents get [#sim-knowledge-documents-get] Get Document ```bash sim knowledge documents get ``` **Arguments** | Argument | Required | Description | | ----------------- | -------- | ------------------------------------- | | `knowledgeBaseId` | Yes | Unique knowledge base identifier. | | `documentId` | Yes | Unique knowledge document identifier. | ### sim knowledge documents list [#sim-knowledge-documents-list] List Documents ```bash sim knowledge documents list [options] ``` **Arguments** | Argument | Required | Description | | ----------------- | -------- | --------------------------------- | | `knowledgeBaseId` | Yes | Unique knowledge base identifier. | **Options** | Option | Required | Description | | -------------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--limit ` | No | Maximum items to return (0 for everything). Defaults to `100`. | | `--search ` | No | Case-insensitive substring match against the document filename. | | `--enabled-filter ` | No | Filter by whether documents are enabled for search. Accepted values: `all`, `enabled`, `disabled`. | | `--sort-by ` | No | Field used to sort the result. Sorting by `filename` is case-sensitive and follows the storage collation, so do not rely on a case-insensitive order. Accepted values: `filename`, `fileSize`, `tokenCount`, `chunkCount`, `uploadedAt`, `processingStatus`, `enabled`. | | `--sort-order ` | No | Sort direction. Accepted values: `asc`, `desc`. | | `--cursor ` | No | Continue from nextCursor returned by a previous result. | | `--tag-filters ` | No | A JSON-encoded array of at most 10 tag filters, using the same display-name shape as knowledge search: `[{"tagName":"category","operator":"eq","value":"billing"}]`. Every filter must hold, including two that name the same tag. A name that is not defined in this knowledge base is rejected, never ignored. | ### sim knowledge documents update [#sim-knowledge-documents-update] Update Document (OAuth login or personal API key required) ```bash sim knowledge documents update [options] ``` **Arguments** | Argument | Required | Description | | ----------------- | -------- | ------------------------------------- | | `knowledgeBaseId` | Yes | Unique knowledge base identifier. | | `documentId` | Yes | Unique knowledge document identifier. | **Options** | Option | Required | Description | | -------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--filename ` | No | New filename for the document. | | `--enabled` | No | Whether the document participates in search. Disabling keeps it indexed. | | `--no-enabled` | No | Send --enabled as false. | | `--tag1 ` | No | New value for tag slot 1. | | `--tag2 ` | No | New value for tag slot 2. | | `--tag3 ` | No | New value for tag slot 3. | | `--tag4 ` | No | New value for tag slot 4. | | `--tag5 ` | No | New value for tag slot 5. | | `--tag6 ` | No | New value for tag slot 6. | | `--tag7 ` | No | New value for tag slot 7. | | `--number1 ` | No | New value for number tag slot 1. | | `--number2 ` | No | New value for number tag slot 2. | | `--number3 ` | No | New value for number tag slot 3. | | `--number4 ` | No | New value for number tag slot 4. | | `--number5 ` | No | New value for number tag slot 5. | | `--date1 ` | No | New value for date tag slot 1, formatted YYYY-MM-DD. | | `--date2 ` | No | New value for date tag slot 2, formatted YYYY-MM-DD. | | `--boolean1` | No | New value for boolean tag slot 1. | | `--no-boolean1` | No | Send --boolean1 as false. | | `--boolean2` | No | New value for boolean tag slot 2. | | `--no-boolean2` | No | Send --boolean2 as false. | | `--boolean3` | No | New value for boolean tag slot 3. | | `--no-boolean3` | No | Send --boolean3 as false. | | `--retry-processing` | No | Requeue a failed or stuck document for processing. Send it alone — no other field may accompany it — and it answers with a queue acknowledgement rather than the document. | ### sim knowledge documents upload [#sim-knowledge-documents-upload] Upload a document to a knowledge base ```bash sim knowledge documents upload [options] ``` **Arguments** | Argument | Required | Description | | ----------------- | -------- | ----------------------------- | | `knowledgeBaseId` | Yes | Knowledge base to upload into | | `path` | Yes | Local file to upload | **Options** | Option | Required | Description | | ------------------ | -------- | ------------------------------------------------------------------------------------------ | | `--name ` | No | Store it under a different name. | | `--tag ` | No | Document tags, in tag1 through tag7 order. | | `--recipe ` | No | Document processing recipe. Accepted values: `default`, `plain`, `markdown`, `code`. | | `--lang ` | No | Document language tag: hyphen-separated letter and digit subtags, for example en or en-US. | ### sim knowledge create [#sim-knowledge-create] Create Knowledge Base ```bash sim knowledge create [options] ``` **Options** | Option | Required | Description | | --------------------------------- | -------- | --------------------------------------------------------------------------------------------------------- | | `--name ` | Yes | Human-readable knowledge base name. | | `--description ` | No | Optional knowledge base description. | | `--chunking-config ` | No | Chunking configuration; defaults are applied when omitted. (JSON, or @path / @- to read a file or stdin). | | `--folder ` | No | Folder path as shown in the app; the leading / is optional. | ### sim knowledge connectors create [#sim-knowledge-connectors-create] Create Knowledge Connector (OAuth login or personal API key required) ```bash sim knowledge connectors create [options] ``` **Arguments** | Argument | Required | Description | | ----------------- | -------- | --------------------------------- | | `knowledgeBaseId` | Yes | Unique knowledge base identifier. | **Options** | Option | Required | Description | | --------------------------------- | -------- | --------------------------------------------------------------------------------------------------------------- | | `--connector-type ` | Yes | Registered connector type. | | `--credential-id ` | No | OAuth credential identifier for connectors that require OAuth. | | `--api-key ` | No | Write-only API key for connectors that use API-key authentication. | | `--source-config ` | Yes | Connector-specific source selection and filtering configuration. (JSON, or @path / @- to read a file or stdin). | | `--sync-interval-minutes ` | No | Scheduled synchronization interval in minutes; zero disables scheduling. | ### sim knowledge connectors delete [#sim-knowledge-connectors-delete] Delete Knowledge Connector (OAuth login or personal API key required) ```bash sim knowledge connectors delete [options] ``` **Arguments** | Argument | Required | Description | | ----------------- | -------- | --------------------------------------- | | `knowledgeBaseId` | Yes | Knowledge base that owns the connector. | | `connectorId` | Yes | Connector selected for the operation. | **Options** | Option | Required | Description | | ----------------------- | -------- | ------------------------------------------------------------- | | `--delete-documents` | No | Also permanently delete documents produced by this connector. | | `--no-delete-documents` | No | Send --delete-documents as false. | | `-y, --yes` | Yes | Confirm this operation. | ### sim knowledge connectors get [#sim-knowledge-connectors-get] Get Knowledge Connector (OAuth login or personal API key required) ```bash sim knowledge connectors get ``` **Arguments** | Argument | Required | Description | | ----------------- | -------- | --------------------------------------- | | `knowledgeBaseId` | Yes | Knowledge base that owns the connector. | | `connectorId` | Yes | Connector selected for the operation. | ### sim knowledge connectors documents list [#sim-knowledge-connectors-documents-list] List Knowledge Connector Documents (OAuth login or personal API key required) ```bash sim knowledge connectors documents list [options] ``` **Arguments** | Argument | Required | Description | | ----------------- | -------- | --------------------------------------- | | `knowledgeBaseId` | Yes | Knowledge base that owns the connector. | | `connectorId` | Yes | Connector selected for the operation. | **Options** | Option | Required | Description | | ----------------------- | -------- | -------------------------------------------------------------- | | `--include-excluded` | No | Include documents explicitly excluded by a user. | | `--no-include-excluded` | No | Send --include-excluded as false. | | `--limit ` | No | Maximum items to return (0 for everything). Defaults to `100`. | | `--cursor ` | No | Continue from nextCursor returned by a previous result. | ### sim knowledge connectors documents update [#sim-knowledge-connectors-documents-update] Update Knowledge Connector Documents (OAuth login or personal API key required) ```bash sim knowledge connectors documents update [options] ``` **Arguments** | Argument | Required | Description | | ----------------- | -------- | --------------------------------------- | | `knowledgeBaseId` | Yes | Knowledge base that owns the connector. | | `connectorId` | Yes | Connector selected for the operation. | **Options** | Option | Required | Description | | ----------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------ | | `--operation ` | Yes | Whether to restore or exclude the selected documents. Accepted values: `restore`, `exclude`. | | `--document ` | Yes | Connector document identifiers to update. (space-separated, or @path / @- with one value per line; @@value for a literal leading @). | ### sim knowledge connectors list [#sim-knowledge-connectors-list] List Knowledge Connectors (OAuth login or personal API key required) ```bash sim knowledge connectors list [options] ``` **Arguments** | Argument | Required | Description | | ----------------- | -------- | --------------------------------- | | `knowledgeBaseId` | Yes | Unique knowledge base identifier. | **Options** | Option | Required | Description | | ---------------------- | -------- | ------------------------------------------------------------------------------------------ | | `--sort-by ` | No | Field used to sort the result. Accepted values: `connectorType`, `createdAt`, `updatedAt`. | | `--sort-order ` | No | Sort direction. Accepted values: `asc`, `desc`. | | `--limit ` | No | Maximum items to return (0 for everything). Defaults to `0`. | ### sim knowledge connectors sync [#sim-knowledge-connectors-sync] Queue a knowledge connector synchronization (OAuth login or personal API key required) ```bash sim knowledge connectors sync [options] ``` **Arguments** | Argument | Required | Description | | ----------------- | -------- | --------------------------------------- | | `knowledgeBaseId` | Yes | Knowledge base that owns the connector. | | `connectorId` | Yes | Connector selected for the operation. | **Options** | Option | Required | Description | | ---------------- | -------- | -------------------------------------------------------- | | `--rehydrate` | No | Re-fetch and re-index every existing connector document. | | `--no-rehydrate` | No | Send --rehydrate as false. | ### sim knowledge connectors update [#sim-knowledge-connectors-update] Update Knowledge Connector (OAuth login or personal API key required) ```bash sim knowledge connectors update [options] ``` **Arguments** | Argument | Required | Description | | ----------------- | -------- | --------------------------------------- | | `knowledgeBaseId` | Yes | Knowledge base that owns the connector. | | `connectorId` | Yes | Connector selected for the operation. | **Options** | Option | Required | Description | | --------------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--source-config ` | No | Replacement source selection and filtering configuration. Updating a runnable connector queues synchronization; paused connectors remain paused. (JSON, or @path / @- to read a file or stdin). | | `--sync-interval-minutes ` | No | New scheduled synchronization interval in minutes. | | `--status ` | No | New connector state. Accepted values: `active`, `paused`. | ### sim knowledge folders create [#sim-knowledge-folders-create] Create a knowledge folder at a path ```bash sim knowledge folders create ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ---------------------------------------------------------- | | `path` | Yes | Folder path as shown in the app; the leading / is optional | ### sim knowledge folders delete [#sim-knowledge-folders-delete] Delete Folder ```bash sim knowledge folders delete [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ---------------------------------------------------------- | | `path` | Yes | Folder path as shown in the app; the leading / is optional | **Options** | Option | Required | Description | | ------------- | -------- | -------------------------------------- | | `--recursive` | No | Delete the folder and its descendants. | | `-y, --yes` | Yes | Confirm this operation. | ### sim knowledge folders list [#sim-knowledge-folders-list] List knowledge folders ```bash sim knowledge folders list [options] ``` Also available as `sim knowledge folders ls`. **Options** | Option | Required | Description | | ---------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--parent ` | No | Direct parent folder path. | | `--search ` | No | Case-insensitive substring match against the folder name. | | `--sort-by ` | No | Field used to sort the result. Sorting by `name` is case-sensitive and follows the storage collation, so do not rely on a case-insensitive order. Accepted values: `name`, `createdAt`, `updatedAt`. | | `--sort-order ` | No | Sort direction. Accepted values: `asc`, `desc`. | ### sim knowledge folders move [#sim-knowledge-folders-move] Rename or move a knowledge folder ```bash sim knowledge folders move ``` Also available as `sim knowledge folders mv`. **Arguments** | Argument | Required | Description | | ------------- | -------- | ---------------------------------------------------------- | | `path` | Yes | Folder path as shown in the app; the leading / is optional | | `destination` | Yes | Folder path as shown in the app; the leading / is optional | ### sim knowledge delete [#sim-knowledge-delete] Delete Knowledge Base ```bash sim knowledge delete [options] ``` **Arguments** | Argument | Required | Description | | ----------------- | -------- | --------------------------------- | | `knowledgeBaseId` | Yes | Unique knowledge base identifier. | **Options** | Option | Required | Description | | ----------- | -------- | ----------------------- | | `-y, --yes` | Yes | Confirm this operation. | ### sim knowledge get [#sim-knowledge-get] Get Knowledge Base ```bash sim knowledge get ``` **Arguments** | Argument | Required | Description | | ----------------- | -------- | --------------------------------- | | `knowledgeBaseId` | Yes | Unique knowledge base identifier. | ### sim knowledge list [#sim-knowledge-list] List Knowledge Bases ```bash sim knowledge list [options] ``` **Options** | Option | Required | Description | | ---------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--scope ` | No | Lifecycle scope: active or archived knowledge bases. Use Restore Knowledge Base to recover archived entries. Folder paths resolve only active folders, so filtering by an archived folder returns no matches. Accepted values: `active`, `archived`. | | `--folder ` | No | Folder path as shown in the app; the leading / is optional. | | `--search ` | No | Case-insensitive substring match against the resource name. | | `--sort-by ` | No | Field used to sort the result. Sorting by `name` is case-sensitive and follows the storage collation, so do not rely on a case-insensitive order. Accepted values: `name`, `createdAt`, `updatedAt`. | | `--sort-order ` | No | Sort direction. Accepted values: `asc`, `desc`. | | `--limit ` | No | Maximum items to return (0 for everything). Defaults to `0`. | ### sim knowledge restore [#sim-knowledge-restore] Restore an archived knowledge base ```bash sim knowledge restore ``` **Arguments** | Argument | Required | Description | | ----------------- | -------- | --------------------------------- | | `knowledgeBaseId` | Yes | Unique knowledge base identifier. | ### sim knowledge search [#sim-knowledge-search] Search Knowledge ```bash sim knowledge search [options] ``` **Options** | Option | Required | Description | | -------------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--kb ` | Yes | Knowledge base ID (repeatable) (space-separated, or @path / @- with one value per line; @@value for a literal leading @). | | `--query ` | No | Text to search for. | | `--top-k ` | No | Maximum number of search results to return. Must be a whole number between 1 and 100. | | `--tag-filters ` | No | Tag filters as \[\{"tagName":"...","operator":"...","value":"..."}] (JSON, or @path / @- to read a file or stdin). | | `--search-mode ` | No | Search algorithm. Accepted values: `vector`, `hybrid`. | | `--reranker-enabled` | No | Re-order retrieved chunks with a reranking model before truncating to `topK`. Ignored for a tag-only search, and billed as an additional search unit. Reranking is best-effort — a provider failure falls back to vector ordering, so check `rerankerStatus` on the response. | | `--no-reranker-enabled` | No | Send --reranker-enabled as false. | | `--reranker-model ` | No | Reranking model to use when `rerankerEnabled` is true. Defaults to `rerank-v4.0-fast`. Accepted values: `rerank-v4.0-pro`, `rerank-v4.0-fast`, `rerank-v3.5`. | | `--reranker-input-count ` | No | How many candidate chunks to retrieve before reranking. Defaults to four times `topK`, capped at 100. A larger pool costs more retrieval work but gives the reranker more to choose from. | ### sim knowledge update [#sim-knowledge-update] Update Knowledge Base ```bash sim knowledge update [options] ``` **Arguments** | Argument | Required | Description | | ----------------- | -------- | --------------------------------- | | `knowledgeBaseId` | Yes | Unique knowledge base identifier. | **Options** | Option | Required | Description | | --------------------------------- | -------- | ----------------------------------------------------------------------------------- | | `--name ` | No | New knowledge base name. | | `--description ` | No | New knowledge base description. | | `--chunking-config ` | No | New document chunking configuration. (JSON, or @path / @- to read a file or stdin). | | `--folder ` | No | Folder path as shown in the app; the leading / is optional. | ### sim knowledge mv [#sim-knowledge-mv] Move a knowledge base to a folder ```bash sim knowledge mv ``` **Arguments** | Argument | Required | Description | | ----------------- | -------- | ---------------------------------------------------------- | | `knowledgeBaseId` | Yes | Unique knowledge base identifier. | | `folder` | Yes | Folder path as shown in the app; the leading / is optional | ### sim knowledge export [#sim-knowledge-export] Export a knowledge base as a .simkb.zip bundle ```bash sim knowledge export [options] ``` **Arguments** | Argument | Required | Description | | ----------------- | -------- | ------------------------ | | `knowledgeBaseId` | Yes | Knowledge base to export | **Options** | Option | Required | Description | | -------------------------- | -------- | ----------------------------------------------------------------------------------------------------- | | `-o, --output-file ` | No | Write the bundle to this path instead of the name the server suggests; pass - to stream it to stdout. | | `--force` | No | Overwrite --output-file if it already exists. | | `--no-vectors` | No | Leave chunk vectors out of the bundle, so an import re-embeds every chunk. | ### sim knowledge ls [#sim-knowledge-ls] List knowledge resources and child folders together ```bash sim knowledge ls [path] [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ------------------------------------------------ | | `path` | No | Folder path to list; defaults to the root folder | **Options** | Option | Required | Description | | ----------------- | -------- | --------------------------------------------------------------------- | | `--search ` | No | Filter folders and resources by name. | | `--limit ` | No | Maximum combined items to return (0 for everything). Defaults to `0`. | ### sim knowledge mkdir [#sim-knowledge-mkdir] Create a knowledge directory at a path ```bash sim knowledge mkdir ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ------------------------------------------------ | | `path` | Yes | Folder path to create; the leading / is optional | ## sim logs [#sim-logs] Also spelled `sim log`. ### sim logs get [#sim-logs-get] Show run diagnostics ```bash sim logs get [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ------------------------------- | | `runId` | Yes | Unique workflow run identifier. | **Options** | Option | Required | Description | | --------- | -------- | ------------------------------------------------------------------------- | | `--trace` | No | Show expanded trace spans with inputs, outputs, errors, timing, and cost. | ### sim logs stats [#sim-logs-stats] Summarize run counts, failures and latency over a window ```bash sim logs stats [options] ``` **Options** | Option | Required | Description | | ------------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--workflow ` | No | Comma-separated workflow identifiers to include. At most 200 entries. An empty entry is rejected. (space-separated, or @path / @- with one value per line; @@value for a literal leading @). | | `--folder ` | No | Folder path as shown in the app; the leading / is optional (space-separated, or @path / @- with one value per line; @@value for a literal leading @). | | `--trigger ` | No | Comma-separated trigger types to include. An empty entry is rejected. The vocabulary is open, so an unrecognized member selects no runs; the literal `all` disables this filter. (space-separated, or @path / @- with one value per line; @@value for a literal leading @). | | `--level ` | No | Severity level to include. Accepted values: `info`, `error`. | | `--start-date ` | No | Only include runs started at or after this UTC ISO 8601 timestamp, e.g. `2026-08-06T00:00:00Z`. A date without a time, or a timestamp carrying a UTC offset instead of `Z`, is rejected, as is year `0000`, which names no storable instant. | | `--end-date ` | No | Only include runs started at or before this UTC ISO 8601 timestamp, e.g. `2026-08-06T00:00:00Z`. A date without a time, or a timestamp carrying a UTC offset instead of `Z`, is rejected, as is year `0000`, which names no storable instant. | | `--segment-count ` | No | Number of time buckets, up to 500. Exactly this many are returned, each at least one minute wide. Short windows extend past the requested end and include empty trailing buckets. | ### sim logs list [#sim-logs-list] List Logs ```bash sim logs list [options] ``` **Options** | Option | Required | Description | | --------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--workflow ` | No | Comma-separated workflow identifiers to include. An empty entry is rejected. At most 200 entries. (space-separated, or @path / @- with one value per line; @@value for a literal leading @). | | `--trigger ` | No | Comma-separated, lowercase trigger types or webhook provider IDs. Matching is exact and case-sensitive; unknown values select no runs. An empty entry is rejected. The sentinel `all` disables this filter, even when listed with other values. At most 100 entries. (space-separated, or @path / @- with one value per line; @@value for a literal leading @). | | `--level ` | No | Severity level to include. Accepted values: `info`, `error`. | | `--start-date ` | No | Only include runs started at or after this UTC ISO 8601 timestamp, e.g. `2026-08-06T00:00:00Z`. A date without a time, or a timestamp carrying a UTC offset instead of `Z`, is rejected, as is year `0000`, which names no storable instant. | | `--end-date ` | No | Only include runs started at or before this UTC ISO 8601 timestamp, e.g. `2026-08-06T00:00:00Z`. A date without a time, or a timestamp carrying a UTC offset instead of `Z`, is rejected, as is year `0000`, which names no storable instant. | | `--min-duration-ms ` | No | Minimum total execution duration in milliseconds. Whole milliseconds from 0 to 2147483647; the stored duration is a 32-bit integer, so a fractional or out-of-range bound is rejected. | | `--max-duration-ms ` | No | Maximum total execution duration in milliseconds. Whole milliseconds from 0 to 2147483647; the stored duration is a 32-bit integer, so a fractional or out-of-range bound is rejected. | | `--min-cost ` | No | Minimum execution cost in USD, from 0 to 1000000. A run is never charged a negative amount, so a negative bound is rejected rather than treated as a filter that matches every run. | | `--max-cost ` | No | Maximum execution cost in USD, from 0 to 1000000. A run is never charged a negative amount, so a negative bound is rejected rather than treated as a filter that matches every run. | | `--model ` | No | AI model used during execution. | | `--details ` | No | Response detail level; full is requested by default to name each run’s workflow. Accepted values: `basic`, `full`. | | `--include-trace-spans` | No | Include trace spans in JSON or YAML output (implies full detail). | | `--include-final-output` | No | Include final output in JSON or YAML output (implies full detail). | | `--limit ` | No | Maximum items to return (0 for everything). Defaults to `100`. | | `--cursor ` | No | Continue from nextCursor returned by a previous result. | | `--status ` | No | Comma-separated execution statuses to include, from `pending` \| `running` \| `paused` \| `redacting` \| `completed` \| `failed` \| `cancelled`. An empty entry is rejected. ANDed with `level`, which reports severity rather than lifecycle. | | `--workflow-name ` | No | Case-insensitive substring match against the run's workflow name. Runs whose workflow has been deleted match nothing, because the name is no longer joinable. | | `--include-job-runs` | No | Include Chat and Sim-agent jobs alongside workflow runs. Jobs use `kind: "job"` and have no workflow or cost ledger. Workflow, folder, model, or status filters exclude jobs. This option is valid only when sorting by `startedAt`. | | `--no-include-job-runs` | No | Send --include-job-runs as false. | | `--run-id ` | No | Exact run identifier to match. | | `--sort-by ` | No | Field used to sort the result. `durationMs` and `cost` are null until a run settles; those runs sort before recorded values in ascending order and after them in descending order. Only `startedAt` can order Chat and Sim-agent job runs, so any other value is rejected when job runs are included. Accepted values: `startedAt`, `durationMs`, `cost`, `status`. | | `--sort-order ` | No | Sort direction. Accepted values: `asc`, `desc`. | | `--folder ` | No | Folder path as shown in the app; the leading / is optional (space-separated, or @path / @- with one value per line; @@value for a literal leading @). | ### sim logs follow [#sim-logs-follow] Watch runs as they arrive, printing each new run once ```bash sim logs follow [options] ``` **Options** | Option | Required | Description | | ---------------------- | -------- | ------------------------------------------------------------------------------------------------------------ | | `--workflow ` | No | Only follow runs of this workflow (repeatable). | | `--folder ` | No | Only follow runs of workflows in this folder (repeatable). | | `--trigger ` | No | Only follow runs with this trigger type (repeatable). | | `--level ` | No | Only follow runs at this severity. Accepted values: `info`, `error`. | | `--details ` | No | Response detail level; full names each run’s workflow. Accepted values: `basic`, `full`. Defaults to `full`. | | `-n, --lines ` | No | Recent runs to print before watching. Defaults to `10`. | | `--interval ` | No | Seconds between polls. Defaults to `3`. | ## sim mcp-servers [#sim-mcp-servers] Also spelled `sim mcp-server`. ### sim mcp-servers create [#sim-mcp-servers-create] Create MCP Server ```bash sim mcp-servers create [options] ``` **Options** | Option | Required | Description | | ------------------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--name ` | Yes | Server display name. | | `--description ` | No | Optional server description. | | `--transport ` | No | Transport protocol. Defaults to `streamable-http` on creation. Accepted values: `streamable-http`. | | `--url ` | Yes | Absolute HTTP or HTTPS endpoint URL without `{{ENV_VAR}}` references. It determines server identity and is immutable: delete and recreate the server to change endpoints. | | `--auth-type ` | No | Authentication method. When omitted, and no `headers` are sent, registration probes the endpoint once to classify it, falling back to `headers` when the probe fails or the server does not advertise OAuth. A server publishing RFC 9728 metadata is therefore stored as `oauth`, and headers configured afterwards will not authenticate — send this field explicitly to pin the method. Accepted values: `none`, `headers`, `oauth`. | | `--headers ` | No | Write-only request headers sent to the server. Replaced wholesale rather than merged on update: sending this field drops every stored header it does not repeat. (JSON, or @path / @- to read a file or stdin). | | `--timeout ` | No | Per-request timeout in milliseconds. Defaults to 30000 on creation. | | `--retries ` | No | Number of retries per request. Defaults to 3 on creation. | | `--enabled` | No | Whether workflows can use the server's tools. Defaults to true on creation. | | `--no-enabled` | No | Send --enabled as false. | | `--oauth-client-id ` | No | Pre-registered OAuth client identifier. Changing it on update revokes the stored OAuth grant and forces reauthorization. | | `--oauth-client-secret ` | No | Write-only pre-registered OAuth client secret. Sending it on update as null or a new value revokes the stored OAuth grant and forces reauthorization, as does switching away from OAuth authentication. (--oauth-client-secret null sends the word, not JSON null). | ### sim mcp-servers delete [#sim-mcp-servers-delete] Delete MCP Server ```bash sim mcp-servers delete [options] ``` **Arguments** | Argument | Required | Description | | ------------- | -------- | ----------------------------- | | `mcpServerId` | Yes | Unique MCP server identifier. | **Options** | Option | Required | Description | | ----------- | -------- | ----------------------- | | `-y, --yes` | Yes | Confirm this operation. | ### sim mcp-servers get [#sim-mcp-servers-get] Get MCP Server ```bash sim mcp-servers get ``` **Arguments** | Argument | Required | Description | | ------------- | -------- | ----------------------------- | | `mcpServerId` | Yes | Unique MCP server identifier. | ### sim mcp-servers list [#sim-mcp-servers-list] List MCP Servers ```bash sim mcp-servers list [options] ``` **Options** | Option | Required | Description | | ---------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--search ` | No | Case-insensitive substring match against the server name. | | `--sort-by ` | No | Field used to sort the result. Sorting by `name` is case-sensitive and follows the storage collation, so do not rely on a case-insensitive order. Accepted values: `name`, `createdAt`, `updatedAt`. | | `--sort-order ` | No | Sort direction. Accepted values: `asc`, `desc`. | | `--limit ` | No | Maximum items to return (0 for everything). Defaults to `0`. | ### sim mcp-servers tools list [#sim-mcp-servers-tools-list] List MCP Server Tools (OAuth login or personal API key required) ```bash sim mcp-servers tools list [options] ``` **Arguments** | Argument | Required | Description | | ------------- | -------- | ----------------------------- | | `mcpServerId` | Yes | Unique MCP server identifier. | **Options** | Option | Required | Description | | -------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------- | | `--refresh` | No | Refresh tools using your credentials. Otherwise results may reuse another workspace member's recent discovery and omit newly added tools. | | `--no-refresh` | No | Send --refresh as false. | ### sim mcp-servers update [#sim-mcp-servers-update] Update MCP Server ```bash sim mcp-servers update [options] ``` **Arguments** | Argument | Required | Description | | ------------- | -------- | ----------------------------- | | `mcpServerId` | Yes | Unique MCP server identifier. | **Options** | Option | Required | Description | | ------------------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--name ` | No | Server display name. | | `--description ` | No | Optional server description. | | `--transport ` | No | Transport protocol. Defaults to `streamable-http` on creation. Accepted values: `streamable-http`. | | `--url ` | No | Immutable server URL. When provided, it must equal the current URL; use delete and create to change endpoints. | | `--auth-type ` | No | Authentication method. When omitted, and no `headers` are sent, registration probes the endpoint once to classify it, falling back to `headers` when the probe fails or the server does not advertise OAuth. A server publishing RFC 9728 metadata is therefore stored as `oauth`, and headers configured afterwards will not authenticate — send this field explicitly to pin the method. Accepted values: `none`, `headers`, `oauth`. | | `--headers ` | No | Write-only request headers sent to the server. Replaced wholesale rather than merged on update: sending this field drops every stored header it does not repeat. (JSON, or @path / @- to read a file or stdin). | | `--timeout ` | No | Per-request timeout in milliseconds. Defaults to 30000 on creation. | | `--retries ` | No | Number of retries per request. Defaults to 3 on creation. | | `--enabled` | No | Whether workflows can use the server's tools. Defaults to true on creation. | | `--no-enabled` | No | Send --enabled as false. | | `--oauth-client-id ` | No | Pre-registered OAuth client identifier. Changing it on update revokes the stored OAuth grant and forces reauthorization. | | `--oauth-client-secret ` | No | Write-only pre-registered OAuth client secret. Sending it on update as null or a new value revokes the stored OAuth grant and forces reauthorization, as does switching away from OAuth authentication. (--oauth-client-secret null sends the word, not JSON null). | ## sim meta [#sim-meta] ### sim meta status [#sim-meta-status] Show what this API supports and which limits apply ```bash sim meta status ``` ## sim sandboxes [#sim-sandboxes] Also spelled `sim sandbox`. ### sim sandboxes create [#sim-sandboxes-create] Create Sandbox (OAuth login or personal API key required) ```bash sim sandboxes create [options] ``` **Options** | Option | Required | Description | | ------------------------------ | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--name ` | Yes | Display name, unique within the workspace; 1 to 64 characters. | | `--language ` | Yes | Dependency ecosystem: `javascript` installs from npm, `python` from PyPI. Accepted values: `javascript`, `python`. | | `--dependencies ` | No | Package specifiers installed into the sandbox, one per entry. (space-separated, or @path / @- with one value per line; in a file, blank lines and # comments are ignored, while inline values are sent as typed and may not be empty; @@value for a literal leading @). | | `--cli-tools ` | No | Pinned managed CLI ids installed into the sandbox, at most 10, no duplicates. (space-separated, or @path / @- with one value per line; @@value for a literal leading @). | | `--system-packages ` | No | Debian packages installed into the sandbox, one per entry. (space-separated, or @path / @- with one value per line; in a file, blank lines and # comments are ignored, while inline values are sent as typed and may not be empty; @@value for a literal leading @). | ### sim sandboxes delete [#sim-sandboxes-delete] Delete Sandbox (OAuth login or personal API key required) ```bash sim sandboxes delete [options] ``` **Arguments** | Argument | Required | Description | | ----------- | -------- | -------------------------- | | `sandboxId` | Yes | Unique sandbox identifier. | **Options** | Option | Required | Description | | ----------- | -------- | ----------------------- | | `-y, --yes` | Yes | Confirm this operation. | ### sim sandboxes get [#sim-sandboxes-get] Get Sandbox ```bash sim sandboxes get ``` **Arguments** | Argument | Required | Description | | ----------- | -------- | -------------------------- | | `sandboxId` | Yes | Unique sandbox identifier. | ### sim sandboxes list [#sim-sandboxes-list] List Sandboxes ```bash sim sandboxes list [options] ``` **Options** | Option | Required | Description | | ---------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--search ` | No | Case-insensitive substring match against the sandbox name. | | `--sort-by ` | No | Field used to sort the result. Sorting by `name` is case-sensitive and follows the storage collation, so do not rely on a case-insensitive order. Accepted values: `name`, `createdAt`, `updatedAt`. | | `--sort-order ` | No | Sort direction. Accepted values: `asc`, `desc`. | | `--limit ` | No | Maximum items to return (0 for everything). Defaults to `0`. | ### sim sandboxes update [#sim-sandboxes-update] Update Sandbox (OAuth login or personal API key required) ```bash sim sandboxes update [options] ``` **Arguments** | Argument | Required | Description | | ----------- | -------- | -------------------------- | | `sandboxId` | Yes | Unique sandbox identifier. | **Options** | Option | Required | Description | | ------------------------------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--name ` | No | New display name, unique within the workspace; 1 to 64 characters. | | `--language ` | No | Replacement dependency ecosystem. The whole spec is revalidated against it, so a Python dependency list does not survive a switch to JavaScript. Accepted values: `javascript`, `python`. | | `--dependencies ` | No | Replacement package list; replaces the whole list. (space-separated, or @path / @- with one value per line; in a file, blank lines and # comments are ignored, while inline values are sent as typed and may not be empty; @@value for a literal leading @). | | `--cli-tools ` | No | Replacement managed CLI list; replaces the whole list. (space-separated, or @path / @- with one value per line; @@value for a literal leading @). | | `--system-packages ` | No | Replacement Debian package list; replaces the whole list. (space-separated, or @path / @- with one value per line; in a file, blank lines and # comments are ignored, while inline values are sent as typed and may not be empty; @@value for a literal leading @). | ## sim secrets [#sim-secrets] Also spelled `sim secret`. ### sim secrets delete [#sim-secrets-delete] Delete Secret (OAuth login or personal API key required) ```bash sim secrets delete [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ----------------- | | `name` | Yes | Secret to delete. | **Options** | Option | Required | Description | | ----------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--scope ` | Yes | Whether the secret belongs to the workspace or to the caller. A personal secret belongs to the caller across every workspace, not to one workspace. Accepted values: `workspace`, `personal`. | | `-y, --yes` | Yes | Confirm this operation. | ### sim secrets list [#sim-secrets-list] List Secrets (OAuth login or personal API key required) ```bash sim secrets list [options] ``` **Options** | Option | Required | Description | | ---------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--scope ` | No | Restrict results to one ownership scope. Accepted values: `workspace`, `personal`. | | `--search ` | No | Case-insensitive substring match against the secret name. | | `--sort-by ` | No | Field used to sort the result. Sorting by `name` is case-sensitive and follows the storage collation, so do not rely on a case-insensitive order. Accepted values: `name`, `createdAt`, `updatedAt`. | | `--sort-order ` | No | Sort direction. Accepted values: `asc`, `desc`. | | `--limit ` | No | Maximum items to return (0 for everything). Defaults to `0`. | ### sim secrets set [#sim-secrets-set] Create or replace a named secret (OAuth login or personal API key required) ```bash sim secrets set [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | --------------------------------------- | | `name` | Yes | Secret name, as referenced in workflows | **Options** | Option | Required | Description | | ----------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--scope ` | Yes | Secret ownership scope. Accepted values: `workspace`, `personal`. | | `--value ` | No | Secret value. Passing it inline exposes it to shell history and process listings; @path reads it from a file and @- from stdin, verbatim — a trailing newline is part of the value, so write the file with printf rather than echo. Prefix a literal leading @ with a second one. | | `--description ` | No | What the secret is for, shown to teammates; workspace scope only. Omit to leave an existing description unchanged. | | `--unredacted` | No | Opt the workspace secret out of redaction: its value then appears in plaintext in run logs, model-visible content, and files, including publicly shared log links. Workspace scope only — sending it for a personal secret is rejected. Omit it to leave the current setting untouched. Pass --no-unredacted to restore redaction. | | `--no-unredacted` | No | Send --unredacted as false. | ## sim skills [#sim-skills] Also spelled `sim skill`. ### sim skills create [#sim-skills-create] Create Skill (OAuth login or personal API key required) ```bash sim skills create [options] ``` **Options** | Option | Required | Description | | ----------------------- | -------- | ---------------------------------------------------------------------------------- | | `--name ` | Yes | Kebab-case name, unique within the workspace and not reserved by a built-in skill. | | `--description ` | Yes | One-line summary of when the skill applies. | | `--content ` | Yes | Skill body containing the instructions given to the agent. | ### sim skills delete [#sim-skills-delete] Delete Skill (OAuth login or personal API key required) ```bash sim skills delete [options] ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------------------------------------------------------------------------------------------- | | `skillId` | Yes | Unique skill identifier. A built-in skill is `builtin-` followed by its name, for example `builtin-research`. | **Options** | Option | Required | Description | | ----------- | -------- | ----------------------- | | `-y, --yes` | Yes | Confirm this operation. | ### sim skills get [#sim-skills-get] Get Skill ```bash sim skills get ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------------------------------------------------------------------------------------------- | | `skillId` | Yes | Unique skill identifier. A built-in skill is `builtin-` followed by its name, for example `builtin-research`. | ### sim skills editors create [#sim-skills-editors-create] Grant Skill Editor (OAuth login or personal API key required) ```bash sim skills editors create [options] ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------------------------------------------------------------------------------------------- | | `skillId` | Yes | Unique skill identifier. A built-in skill is `builtin-` followed by its name, for example `builtin-research`. | **Options** | Option | Required | Description | | ----------------- | -------- | -------------------------------------------- | | `--email ` | Yes | Email address of a current workspace member. | ### sim skills editors list [#sim-skills-editors-list] List Skill Editors ```bash sim skills editors list [options] ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------------------------------------------------------------------------------------------- | | `skillId` | Yes | Unique skill identifier. A built-in skill is `builtin-` followed by its name, for example `builtin-research`. | **Options** | Option | Required | Description | | ---------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--sort-by ` | No | Field used to sort the result. Sorting by `name` is case-sensitive and follows the storage collation, so do not rely on a case-insensitive order. Accepted values: `email`, `name`. | | `--sort-order ` | No | Sort direction. Accepted values: `asc`, `desc`. | | `--limit ` | No | Maximum items to return (0 for everything). Defaults to `0`. | ### sim skills editors delete [#sim-skills-editors-delete] Revoke Skill Editor (OAuth login or personal API key required) ```bash sim skills editors delete [options] ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------------------------------------------------------------------------------------------- | | `skillId` | Yes | Unique skill identifier. A built-in skill is `builtin-` followed by its name, for example `builtin-research`. | **Options** | Option | Required | Description | | ----------------- | -------- | -------------------------------------------- | | `--email ` | Yes | Email address of a current workspace member. | | `-y, --yes` | Yes | Confirm this operation. | ### sim skills list [#sim-skills-list] List Skills ```bash sim skills list [options] ``` **Options** | Option | Required | Description | | ---------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--search ` | No | Case-insensitive substring match against the skill name. | | `--sort-by ` | No | Field used to sort the result. Sorting by `name` is case-sensitive and follows the storage collation, so do not rely on a case-insensitive order. Accepted values: `name`, `createdAt`, `updatedAt`. | | `--sort-order ` | No | Sort direction. Accepted values: `asc`, `desc`. | | `--limit ` | No | Maximum items to return (0 for everything). Defaults to `0`. | ### sim skills update [#sim-skills-update] Update Skill (OAuth login or personal API key required) ```bash sim skills update [options] ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------------------------------------------------------------------------------------------- | | `skillId` | Yes | Unique skill identifier. A built-in skill is `builtin-` followed by its name, for example `builtin-research`. | **Options** | Option | Required | Description | | ----------------------- | -------- | ----------------------------------------------- | | `--name ` | No | New kebab-case skill name. | | `--description ` | No | New one-line summary of when the skill applies. | | `--content ` | No | Replacement skill body. | ## sim tables [#sim-tables] Also spelled `sim table`. ### sim tables columns create [#sim-tables-columns-create] Add Column ```bash sim tables columns create [options] ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------ | | `tableId` | Yes | Unique table identifier. | **Options** | Option | Required | Description | | ------------------------ | -------- | ------------------------------------------------------------------------ | | `--column ` | Yes | Column definition to add. (JSON, or @path / @- to read a file or stdin). | ### sim tables columns delete [#sim-tables-columns-delete] Delete Column ```bash sim tables columns delete [options] ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------ | | `tableId` | Yes | Unique table identifier. | **Options** | Option | Required | Description | | ----------------------- | -------- | ----------------------------- | | `--column-name ` | Yes | Name of the column to delete. | | `-y, --yes` | Yes | Confirm this operation. | ### sim tables columns update [#sim-tables-columns-update] Update Column ```bash sim tables columns update [options] ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------ | | `tableId` | Yes | Unique table identifier. | **Options** | Option | Required | Description | | ------------------------- | -------- | --------------------------------------------------------------------- | | `--column-name ` | Yes | Current name of the column to update. | | `--updates ` | Yes | Mutable column fields. (JSON, or @path / @- to read a file or stdin). | ### sim tables groups create [#sim-tables-groups-create] Add Workflow Group ```bash sim tables groups create [options] ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------ | | `tableId` | Yes | Unique table identifier. | **Options** | Option | Required | Description | | -------------------------------- | -------- | ------------------------------------------------------------------------------------------ | | `--group ` | Yes | Workflow or enrichment producer definition. (JSON, or @path / @- to read a file or stdin). | | `--output-columns ` | Yes | Columns created for producer outputs. (JSON, or @path / @- to read a file or stdin). | | `--auto-run` | No | Whether to schedule existing rows after group creation. | | `--no-auto-run` | No | Send --auto-run as false. | ### sim tables groups delete [#sim-tables-groups-delete] Delete Workflow Group ```bash sim tables groups delete [options] ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------ | | `tableId` | Yes | Unique table identifier. | **Options** | Option | Required | Description | | -------------------- | -------- | ------------------------- | | `--group-id ` | Yes | Workflow group to delete. | | `-y, --yes` | Yes | Confirm this operation. | ### sim tables groups list [#sim-tables-groups-list] List Workflow Groups ```bash sim tables groups list ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------ | | `tableId` | Yes | Unique table identifier. | ### sim tables groups update [#sim-tables-groups-update] Update Workflow Group ```bash sim tables groups update [options] ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------ | | `tableId` | Yes | Unique table identifier. | **Options** | Option | Required | Description | | ------------------------------------ | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--group-id ` | Yes | Workflow group to update. | | `--workflow-id ` | No | Replacement backing workflow identifier. | | `--name ` | No | Replacement workflow-group display name. | | `--dependencies ` | No | Replacement input dependencies. (JSON, or @path / @- to read a file or stdin). | | `--outputs ` | No | Replacement producer outputs. (JSON, or @path / @- to read a file or stdin). | | `--new-output-columns ` | No | Columns to add for new outputs. (JSON, or @path / @- to read a file or stdin). | | `--mapping-updates ` | No | Existing output-column mapping changes. (JSON, or @path / @- to read a file or stdin). | | `--input-mappings ` | No | Replacement workflow input mappings. (JSON, or @path / @- to read a file or stdin). | | `--deployment-mode ` | No | Replacement workflow execution mode. Accepted values: `live`, `deployed`. | | `--type ` | No | Workflow-group producer type. Must match the group's stored type — a group's producer cannot be changed after creation. Accepted values: `manual`, `enrichment`. | | `--auto-run` | No | Replacement automatic-run setting. | | `--no-auto-run` | No | Send --auto-run as false. | ### sim tables batch-delete [#sim-tables-batch-delete] Bulk Delete Tables and Folders ```bash sim tables batch-delete [options] ``` **Options** | Option | Required | Description | | --------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | | `--table-ids ` | No | Tables to archive, by identifier. (JSON, or @path / @- to read a file or stdin). | | `--folder ` | No | Folder path as shown in the app; the leading / is optional (space-separated, or @path / @- with one value per line; @@value for a literal leading @). | | `-y, --yes` | Yes | Confirm this operation. | ### sim tables rows update-each [#sim-tables-rows-update-each] Apply a distinct patch to each listed row ```bash sim tables rows update-each [options] ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------ | | `tableId` | Yes | Unique table identifier. | **Options** | Option | Required | Description | | ------------------------- | -------- | -------------------------------------------------------------------------------------------------------------------- | | `--updates ` | Yes | One merge patch per row. Each row identifier may appear at most once. (JSON, or @path / @- to read a file or stdin). | ### sim tables rows create [#sim-tables-rows-create] Create Rows ```bash sim tables rows create [options] ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------ | | `tableId` | Yes | Unique table identifier. | **Options** | Option | Required | Description | | ---------------------- | -------- | -------------------------------------------------------------------------------------- | | `--data ` | No | One row keyed by column name (JSON, or @path / @-; choose exactly one body flag). | | `--rows ` | No | Several rows keyed by column name (JSON, or @path / @-; choose exactly one body flag). | ### sim tables rows delete [#sim-tables-rows-delete] Delete Row ```bash sim tables rows delete [options] ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ---------------------------- | | `tableId` | Yes | Unique table identifier. | | `rowId` | Yes | Unique table row identifier. | **Options** | Option | Required | Description | | ----------- | -------- | ----------------------- | | `-y, --yes` | Yes | Confirm this operation. | ### sim tables rows batch-delete [#sim-tables-rows-batch-delete] Delete rows matching a filter, or an explicit list of ids ```bash sim tables rows batch-delete [options] ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------ | | `tableId` | Yes | Unique table identifier. | **Options** | Option | Required | Description | | ------------------------ | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--filter ` | No | Predicate: \{"all":\[\{"field":"status","op":"eq","value":"active"}]}; groups use all/any. Operators: eq, ne, gt, gte, lt, lte, in, nin, contains, ncontains, startsWith, endsWith, like, ilike, nlike, nilike, isEmpty, isNotEmpty, isNull, isNotNull (JSON, or @path / @- to read a file or stdin). | | `--limit ` | No | Maximum matching rows to delete. (caps a --filter match only; omit it to act on every match, and note 0 is not accepted). | | `--row ` | No | Explicit row identifiers to delete. (space-separated, or @path / @- with one value per line; @@value for a literal leading @). | | `-y, --yes` | Yes | Confirm this operation. | ### sim tables rows get [#sim-tables-rows-get] Get Row ```bash sim tables rows get [options] ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ---------------------------- | | `tableId` | Yes | Unique table identifier. | | `rowId` | Yes | Unique table row identifier. | **Options** | Option | Required | Description | | ------------------------ | -------- | ------------------------------------------------------------------------- | | `--include-run-state` | No | Include per-workflow-group run state on the returned row. Off by default. | | `--no-include-run-state` | No | Send --include-run-state as false. | ### sim tables rows list [#sim-tables-rows-list] List Rows ```bash sim tables rows list [options] ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------ | | `tableId` | Yes | Unique table identifier. | **Options** | Option | Required | Description | | ------------------------ | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--limit ` | No | Maximum items to return (0 for everything). Defaults to `100`. | | `--cursor ` | No | Continue from nextCursor returned by a previous result. | | `--include-run-state` | No | Include per-workflow-group run state on every returned row. Off by default: run state is a separate sidecar read and its `blockErrors` are unbounded, so a full page carries it only when asked. Caps `limit` at 200. | | `--no-include-run-state` | No | Send --include-run-state as false. | ### sim tables rows query [#sim-tables-rows-query] Query Rows ```bash sim tables rows query [options] ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------ | | `tableId` | Yes | Unique table identifier. | **Options** | Option | Required | Description | | ------------------------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `--filter ` | No | Condition: \{"field":"status","op":"eq","value":"active"}. Groups: \{"all":\[\{"field":"status","op":"eq","value":"active"}]} or \{"any":\[\{"field":"status","op":"eq","value":"active"}]}; group entries may also be nested groups. Operators: eq, ne, gt, gte, lt, lte, in, nin, contains, ncontains, startsWith, endsWith, like, ilike, nlike, nilike, isEmpty, isNotEmpty, isNull, isNotNull (JSON, or @path / @- to read a file or stdin). | | `--sort ` | No | Ordered sort keys: \[\{"field":"createdAt","direction":"desc"}] (direction: asc or desc) (JSON, or @path / @- to read a file or stdin). | | `--limit ` | No | Maximum items to return (0 for everything). Defaults to `100`. | | `--cursor ` | No | Continue from nextCursor returned by a previous result. | | `--include-run-state` | No | Include per-workflow-group run state on every returned row. Off by default: run state is a separate sidecar read and its `blockErrors` are unbounded, so a full page carries it only when asked. Incompatible with `limit: 0`, and caps `limit` at 200. | | `--no-include-run-state` | No | Send --include-run-state as false. | ### sim tables rows count [#sim-tables-rows-count] Count rows matching a filter ```bash sim tables rows count [options] ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------ | | `tableId` | Yes | Unique table identifier. | **Options** | Option | Required | Description | | ------------------------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `--filter ` | No | Condition: \{"field":"status","op":"eq","value":"active"}. Groups: \{"all":\[\{"field":"status","op":"eq","value":"active"}]} or \{"any":\[\{"field":"status","op":"eq","value":"active"}]}; group entries may also be nested groups. Operators: eq, ne, gt, gte, lt, lte, in, nin, contains, ncontains, startsWith, endsWith, like, ilike, nlike, nilike, isEmpty, isNotEmpty, isNull, isNotNull (JSON, or @path / @- to read a file or stdin). | ### sim tables rows enrich [#sim-tables-rows-enrich] Run one row’s enrichment group ```bash sim tables rows enrich ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------------------ | | `tableId` | Yes | Unique table identifier. | | `rowId` | Yes | Unique table row identifier. | | `groupId` | Yes | Workflow or enrichment group to run. | ### sim tables rows search [#sim-tables-rows-search] Search cells for a value and return their coordinates ```bash sim tables rows search [options] ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------ | | `tableId` | Yes | Unique table identifier. | **Options** | Option | Required | Description | | ------------------------ | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--query ` | Yes | Value to search for. | | `--filter ` | No | Predicate: \{"all":\[\{"field":"status","op":"eq","value":"active"}]}; groups use all/any. Operators: eq, ne, gt, gte, lt, lte, in, nin, contains, ncontains, startsWith, endsWith, like, ilike, nlike, nilike, isEmpty, isNotEmpty, isNull, isNotNull (JSON, or @path / @- to read a file or stdin). | | `--sort ` | No | Ordered sort keys: \[\{"field":"createdAt","direction":"desc"}] (direction: asc or desc) (JSON, or @path / @- to read a file or stdin). | ### sim tables rows batch-update [#sim-tables-rows-batch-update] Update every row matching a filter ```bash sim tables rows batch-update [options] ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------ | | `tableId` | Yes | Unique table identifier. | **Options** | Option | Required | Description | | ------------------------ | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--filter ` | Yes | Predicate: \{"all":\[\{"field":"status","op":"eq","value":"active"}]}; groups use all/any. Operators: eq, ne, gt, gte, lt, lte, in, nin, contains, ncontains, startsWith, endsWith, like, ilike, nlike, nilike, isEmpty, isNotEmpty, isNull, isNotNull (JSON, or @path / @- to read a file or stdin). | | `--data ` | Yes | Row-data patch applied to every matching row. (JSON, or @path / @- to read a file or stdin). | | `--limit ` | No | Maximum matching rows to update. (caps a --filter match only; omit it to act on every match, and note 0 is not accepted). | | `-y, --yes` | Yes | Confirm this operation. | ### sim tables rows update [#sim-tables-rows-update] Update Row ```bash sim tables rows update [options] ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ---------------------------- | | `tableId` | Yes | Unique table identifier. | | `rowId` | Yes | Unique table row identifier. | **Options** | Option | Required | Description | | ---------------------- | -------- | ------------------------------------------------------------------------------------------- | | `--data ` | Yes | Partial row-data patch keyed by column name. (JSON, or @path / @- to read a file or stdin). | ### sim tables dispatches cancel [#sim-tables-dispatches-cancel] Cancel a running dispatch ```bash sim tables dispatches cancel [options] ``` **Arguments** | Argument | Required | Description | | ------------ | -------- | ------------------------------------- | | `tableId` | Yes | Unique table identifier. | | `dispatchId` | Yes | Unique table run-dispatch identifier. | **Options** | Option | Required | Description | | ----------- | -------- | ----------------------- | | `-y, --yes` | Yes | Confirm this operation. | ### sim tables dispatches create [#sim-tables-dispatches-create] Start a column or enrichment run ```bash sim tables dispatches create [options] ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------ | | `tableId` | Yes | Unique table identifier. | **Options** | Option | Required | Description | | ------------------------------ | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--group-ids ` | Yes | Workflow or enrichment groups to run. (space-separated, or @path / @- with one value per line; @@value for a literal leading @). | | `--run-mode ` | No | Whether to run all or only incomplete cells. Accepted values: `all`, `incomplete`. | | `--row-ids ` | No | Explicit row subset to run. (space-separated, or @path / @- with one value per line; @@value for a literal leading @). | | `--filter ` | No | Predicate: \{"all":\[\{"field":"status","op":"eq","value":"active"}]}; groups use all/any. Operators: eq, ne, gt, gte, lt, lte, in, nin, contains, ncontains, startsWith, endsWith, like, ilike, nlike, nilike, isEmpty, isNotEmpty, isNull, isNotNull (JSON, or @path / @- to read a file or stdin). | | `--exclude-row-ids ` | No | Rows excluded from a select-all run scope. (space-separated, or @path / @- with one value per line; @@value for a literal leading @). | | `--max-rows ` | No | Stop after this many eligible rows have run (1-1,000,000). Omit for an unbounded run. | ### sim tables dispatches get [#sim-tables-dispatches-get] Get Run Dispatch ```bash sim tables dispatches get ``` **Arguments** | Argument | Required | Description | | ------------ | -------- | ------------------------------------- | | `tableId` | Yes | Unique table identifier. | | `dispatchId` | Yes | Unique table run-dispatch identifier. | ### sim tables dispatches list [#sim-tables-dispatches-list] List Active Run Dispatches ```bash sim tables dispatches list ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------ | | `tableId` | Yes | Unique table identifier. | ### sim tables exports cancel [#sim-tables-exports-cancel] Stop a running export ```bash sim tables exports cancel ``` **Arguments** | Argument | Required | Description | | ---------- | -------- | ------------------------------- | | `tableId` | Yes | Unique table identifier. | | `exportId` | Yes | Unique table-export identifier. | ### sim tables exports create [#sim-tables-exports-create] Create Table Export ```bash sim tables exports create [options] ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------ | | `tableId` | Yes | Unique table identifier. | **Options** | Option | Required | Description | | ------------------ | -------- | --------------------------------------------------- | | `--format ` | No | Export file format. Accepted values: `csv`, `json`. | ### sim tables exports get [#sim-tables-exports-get] Get Table Export ```bash sim tables exports get ``` **Arguments** | Argument | Required | Description | | ---------- | -------- | ------------------------------- | | `tableId` | Yes | Unique table identifier. | | `exportId` | Yes | Unique table-export identifier. | ### sim tables exports download [#sim-tables-exports-download] Get the download URL for a finished export ```bash sim tables exports download ``` **Arguments** | Argument | Required | Description | | ---------- | -------- | ------------------------------- | | `tableId` | Yes | Unique table identifier. | | `exportId` | Yes | Unique table-export identifier. | ### sim tables imports cancel [#sim-tables-imports-cancel] Stop a running import ```bash sim tables imports cancel [options] ``` **Arguments** | Argument | Required | Description | | ---------- | -------- | ------------------------------- | | `importId` | Yes | Unique table-import identifier. | **Options** | Option | Required | Description | | ----------- | -------- | ----------------------- | | `-y, --yes` | Yes | Confirm this operation. | ### sim tables imports get [#sim-tables-imports-get] Get Table Import ```bash sim tables imports get ``` **Arguments** | Argument | Required | Description | | ---------- | -------- | ------------------------------- | | `importId` | Yes | Unique table-import identifier. | ### sim tables cancel-runs [#sim-tables-cancel-runs] Stop every running column job ```bash sim tables cancel-runs [options] ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------ | | `tableId` | Yes | Unique table identifier. | **Options** | Option | Required | Description | | ------------------------------ | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--scope ` | Yes | Whether to cancel across the table or one row. Accepted values: `all`, `row`. | | `--row-id ` | No | Row whose runs should be canceled for row scope. | | `--filter ` | No | Predicate: \{"all":\[\{"field":"status","op":"eq","value":"active"}]}; groups use all/any. Operators: eq, ne, gt, gte, lt, lte, in, nin, contains, ncontains, startsWith, endsWith, like, ilike, nlike, nilike, isEmpty, isNotEmpty, isNull, isNotNull (JSON, or @path / @- to read a file or stdin). | | `--exclude-row-ids ` | No | Rows excluded from an all-scope cancellation. (space-separated, or @path / @- with one value per line; @@value for a literal leading @). | | `-y, --yes` | Yes | Confirm this operation. | ### sim tables create [#sim-tables-create] Create Table ```bash sim tables create [options] ``` **Options** | Option | Required | Description | | ------------------------ | -------- | -------------------------------------------------------------------------------------------------------------- | | `--name ` | Yes | Identifier: letters, numbers, and underscores; cannot start with a number. | | `--description ` | No | Optional table description. | | `--schema ` | Yes | Table schema: \{"columns":\[\{"name":"email","type":"string"}]} (JSON, or @path / @- to read a file or stdin). | | `--folder ` | No | Folder path as shown in the app; the leading / is optional. | ### sim tables folders create [#sim-tables-folders-create] Create a table folder at a path ```bash sim tables folders create ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ---------------------------------------------------------- | | `path` | Yes | Folder path as shown in the app; the leading / is optional | ### sim tables folders delete [#sim-tables-folders-delete] Delete Folder ```bash sim tables folders delete [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ---------------------------------------------------------- | | `path` | Yes | Folder path as shown in the app; the leading / is optional | **Options** | Option | Required | Description | | ------------- | -------- | -------------------------------------- | | `--recursive` | No | Delete the folder and its descendants. | | `-y, --yes` | Yes | Confirm this operation. | ### sim tables folders list [#sim-tables-folders-list] List table folders ```bash sim tables folders list [options] ``` Also available as `sim tables folders ls`. **Options** | Option | Required | Description | | ---------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--parent ` | No | Direct parent folder path. | | `--search ` | No | Case-insensitive substring match against the folder name. | | `--sort-by ` | No | Field used to sort the result. Sorting by `name` is case-sensitive and follows the storage collation, so do not rely on a case-insensitive order. Accepted values: `name`, `createdAt`, `updatedAt`. | | `--sort-order ` | No | Sort direction. Accepted values: `asc`, `desc`. | ### sim tables folders move [#sim-tables-folders-move] Rename or move a table folder ```bash sim tables folders move ``` Also available as `sim tables folders mv`. **Arguments** | Argument | Required | Description | | ------------- | -------- | ---------------------------------------------------------- | | `path` | Yes | Folder path as shown in the app; the leading / is optional | | `destination` | Yes | Folder path as shown in the app; the leading / is optional | ### sim tables folders restore [#sim-tables-folders-restore] Restore an archived table folder ```bash sim tables folders restore ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ---------------------------------------------------------- | | `path` | Yes | Folder path as shown in the app; the leading / is optional | ### sim tables views create [#sim-tables-views-create] Create View ```bash sim tables views create [options] ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------ | | `tableId` | Yes | Unique table identifier. | **Options** | Option | Required | Description | | ------------------------ | -------- | --------------------------------------------------------------------------------------------------- | | `--name ` | Yes | Saved-view display name. | | `--config ` | Yes | Saved filter, sort, and column-layout configuration. (JSON, or @path / @- to read a file or stdin). | ### sim tables views delete [#sim-tables-views-delete] Delete View ```bash sim tables views delete [options] ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ----------------------------- | | `tableId` | Yes | Unique table identifier. | | `viewId` | Yes | Unique saved-view identifier. | **Options** | Option | Required | Description | | ----------- | -------- | ----------------------- | | `-y, --yes` | Yes | Confirm this operation. | ### sim tables views get [#sim-tables-views-get] Get View ```bash sim tables views get ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ----------------------------- | | `tableId` | Yes | Unique table identifier. | | `viewId` | Yes | Unique saved-view identifier. | ### sim tables views list [#sim-tables-views-list] List Views ```bash sim tables views list ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------ | | `tableId` | Yes | Unique table identifier. | ### sim tables views update [#sim-tables-views-update] Update View ```bash sim tables views update [options] ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ----------------------------- | | `tableId` | Yes | Unique table identifier. | | `viewId` | Yes | Unique saved-view identifier. | **Options** | Option | Required | Description | | ------------------------------ | -------- | ------------------------------------------------------------------------------------------------ | | `--name ` | No | Replacement saved-view display name. | | `--config ` | No | Complete replacement saved-view configuration. (JSON, or @path / @- to read a file or stdin). | | `--config-patch ` | No | Saved-view configuration fields to shallow-merge. (JSON, or @path / @- to read a file or stdin). | | `--is-default` | No | Whether to promote this view to the table default. | | `--no-is-default` | No | Send --is-default as false. | ### sim tables delete [#sim-tables-delete] Delete Table ```bash sim tables delete [options] ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------ | | `tableId` | Yes | Unique table identifier. | **Options** | Option | Required | Description | | ----------- | -------- | ----------------------- | | `-y, --yes` | Yes | Confirm this operation. | ### sim tables enrichment get [#sim-tables-enrichment-get] Get Enrichment Run Detail ```bash sim tables enrichment get ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------------------ | | `tableId` | Yes | Unique table identifier. | | `rowId` | Yes | Unique table row identifier. | | `groupId` | Yes | Workflow or enrichment group to run. | ### sim tables get [#sim-tables-get] Get Table ```bash sim tables get ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------ | | `tableId` | Yes | Unique table identifier. | ### sim tables list [#sim-tables-list] List Tables ```bash sim tables list [options] ``` **Options** | Option | Required | Description | | ---------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--scope ` | No | Which lifecycle set to list: `active` (default) for live tables, `archived` for tables a delete archived and a table restore can bring back. `folderPath` resolves against active folders only, so pairing it with `scope=archived` returns an empty page when the containing folder was archived too. Accepted values: `active`, `archived`. | | `--folder ` | No | Folder path as shown in the app; the leading / is optional. | | `--search ` | No | Case-insensitive substring match against the resource name. | | `--sort-by ` | No | Field used to sort the result. Sorting by `name` is case-sensitive and follows the storage collation, so do not rely on a case-insensitive order. Accepted values: `name`, `createdAt`, `updatedAt`. | | `--sort-order ` | No | Sort direction. Accepted values: `asc`, `desc`. | | `--limit ` | No | Maximum items to return (0 for everything). Defaults to `0`. | ### sim tables move [#sim-tables-move] Move Tables and Folders ```bash sim tables move [options] ``` **Options** | Option | Required | Description | | --------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `--table-ids ` | No | Tables to move, by identifier. (JSON, or @path / @- to read a file or stdin). | | `--folder ` | No | Table folders to move, by path as shown in the app; the leading / is optional (space-separated, or @path / @- with one value per line; @@value for a literal leading @). | | `--to ` | No | Destination folder path; omit for root. | ### sim tables restore [#sim-tables-restore] Restore an archived table ```bash sim tables restore ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------ | | `tableId` | Yes | Unique table identifier. | ### sim tables update [#sim-tables-update] Update Table ```bash sim tables update [options] ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------ | | `tableId` | Yes | Unique table identifier. | **Options** | Option | Required | Description | | ----------------------- | -------- | ------------------------------------------------------------------------------------------------------- | | `--name ` | No | Identifier: letters, numbers, and underscores; cannot start with a number. | | `--description ` | No | Replacement table description, or null to clear it. (--description null sends the word, not JSON null). | | `--folder ` | No | Folder path as shown in the app; the leading / is optional. | ### sim tables mv [#sim-tables-mv] Move a table to a folder ```bash sim tables mv ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ---------------------------------------------------------- | | `tableId` | Yes | Unique table identifier. | | `folder` | Yes | Folder path as shown in the app; the leading / is optional | ### sim tables upsert [#sim-tables-upsert] Insert a row, or update the one that conflicts on a unique column ```bash sim tables upsert [options] ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------ | | `tableId` | Yes | Unique table identifier. | **Options** | Option | Required | Description | | ---------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `--data ` | Yes | Complete set of row cells keyed by column name. On the update branch this REPLACES the matched row: any column not present here is cleared, unlike a single-row update, which merges. (JSON, or @path / @- to read a file or stdin). | | `--on ` | No | Unique column to resolve the conflict against. | ### sim tables import [#sim-tables-import] Import a CSV, into a new table by default ```bash sim tables import [path] [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | --------------------------------------------------- | | `path` | No | Local CSV file to import; omit when using --file-id | **Options** | Option | Required | Description | | -------------------------------- | -------- | ----------------------------------------------------------------------------------------------------- | | `--name ` | No | Identifier for the new table: letters, numbers, and underscores; defaults to the sanitized file name. | | `--table-id ` | No | Import into this existing table instead of creating one. | | `--mode ` | No | How to write into --table-id (default: append). Accepted values: `append`, `replace`. | | `--folder ` | No | Folder path for the new table, as shown in the app. | | `--file-id ` | No | Import a file already in the workspace instead of a local path. | | `--mapping ` | No | Column mapping (--table-id only). | | `--create-columns ` | No | Columns to create (--table-id only). | | `--timezone ` | No | Timezone for date parsing, e.g. America/New\_York. | | `-y, --yes` | No | Confirm this destructive operation (required with --mode replace). | | `--no-wait` | No | Return once the import is queued instead of watching it. | ### sim tables ls [#sim-tables-ls] List table resources and child folders together ```bash sim tables ls [path] [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ------------------------------------------------ | | `path` | No | Folder path to list; defaults to the root folder | **Options** | Option | Required | Description | | ----------------- | -------- | --------------------------------------------------------------------- | | `--search ` | No | Filter folders and resources by name. | | `--limit ` | No | Maximum combined items to return (0 for everything). Defaults to `0`. | ### sim tables mkdir [#sim-tables-mkdir] Create a table directory at a path ```bash sim tables mkdir ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ------------------------------------------------ | | `path` | Yes | Folder path to create; the leading / is optional | ## sim tools [#sim-tools] ### sim tools execute [#sim-tools-execute] Run one built-in tool and print what it produced (OAuth login or personal API key required) ```bash sim tools execute [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ------------------------------------------------------------------------------------------------------------- | | `toolId` | Yes | Tool identifier. An unversioned name resolves to the newest version, and the response echoes the resolved id. | **Options** | Option | Required | Description | | ------------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------- | | `--input ` | No | Tool arguments as JSON, keyed by the parameter ids `sim tools get <toolId>` lists (JSON, or @path / @- to read a file or stdin). | | `--credential-id ` | No | Credential to authenticate with, required for OAuth tools. | | `--timeout ` | No | Seconds to wait before abandoning the call. | ### sim tools get [#sim-tools-get] Get Tool ```bash sim tools get ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ------------------------------------------------------------------------------------------------------------- | | `toolId` | Yes | Tool identifier. An unversioned name resolves to the newest version, and the response echoes the resolved id. | ### sim tools list [#sim-tools-list] List Tools ```bash sim tools list [options] ``` **Options** | Option | Required | Description | | -------------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--search ` | No | Case-insensitive substring match against the tool id, name, and description. | | `--hosted-api-key ` | No | Restrict to tools by how their API key is supplied. Accepted values: `always`, `conditional`, `none`. | | `--oauth-provider ` | No | Restrict to tools that authenticate against this OAuth service. | | `--sort-by ` | No | Field used to sort the result. Sorting by `name` is case-sensitive and follows the storage collation, so do not rely on a case-insensitive order. Accepted values: `id`, `name`. | | `--sort-order ` | No | Sort direction. Accepted values: `asc`, `desc`. | | `--limit ` | No | Maximum items to return (0 for everything). Defaults to `0`. | ## sim workflow-mcp-servers [#sim-workflow-mcp-servers] ### sim workflow-mcp-servers create [#sim-workflow-mcp-servers-create] Create Workflow MCP Server (OAuth login or personal API key required) ```bash sim workflow-mcp-servers create [options] ``` **Options** | Option | Required | Description | | ----------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--name ` | Yes | Server display name, shown to connecting MCP clients. | | `--description ` | No | Optional server description. | | `--is-public` | No | Whether the server answers MCP clients without a Sim API key. Defaults to false — a public server executes the workflows it publishes for anyone holding its URL. | | `--no-is-public` | No | Send --is-public as false. | | `--workflow ` | No | Deployed workflows to publish as tools on the new server. (space-separated, or @path / @- with one value per line; @@value for a literal leading @). | ### sim workflow-mcp-servers delete [#sim-workflow-mcp-servers-delete] Delete Workflow MCP Server (OAuth login or personal API key required) ```bash sim workflow-mcp-servers delete [options] ``` **Arguments** | Argument | Required | Description | | ---------- | -------- | -------------------------------------- | | `serverId` | Yes | Unique workflow-MCP server identifier. | **Options** | Option | Required | Description | | ----------- | -------- | ----------------------- | | `-y, --yes` | Yes | Confirm this operation. | ### sim workflow-mcp-servers tools create [#sim-workflow-mcp-servers-tools-create] Publish Workflow As MCP Tool (OAuth login or personal API key required) ```bash sim workflow-mcp-servers tools create [options] ``` **Arguments** | Argument | Required | Description | | ---------- | -------- | -------------------------------------- | | `serverId` | Yes | Unique workflow-MCP server identifier. | **Options** | Option | Required | Description | | ---------------------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--workflow-id ` | Yes | Deployed workflow to publish. The workflow must already be deployed. | | `--tool-name ` | No | Name MCP clients call. Normalized to the MCP tool-name grammar, and derived from the workflow name when omitted. | | `--tool-description ` | No | Description shown to MCP clients. Derived from the workflow name when omitted. | | `--parameter-descriptions ` | No | Per-field description overrides applied to the schema generated from the deployed workflow inputs, as \[\{"name":"email","description":"Customer email address"}]. A name matching no input field is ignored (JSON, or @path / @- to read a file or stdin). | ### sim workflow-mcp-servers tools list [#sim-workflow-mcp-servers-tools-list] List Workflow MCP Tools (OAuth login or personal API key required) ```bash sim workflow-mcp-servers tools list ``` **Arguments** | Argument | Required | Description | | ---------- | -------- | -------------------------------------- | | `serverId` | Yes | Unique workflow-MCP server identifier. | ### sim workflow-mcp-servers tools delete [#sim-workflow-mcp-servers-tools-delete] Unpublish Workflow MCP Tool (OAuth login or personal API key required) ```bash sim workflow-mcp-servers tools delete [options] ``` **Arguments** | Argument | Required | Description | | ------------ | -------- | -------------------------------------------- | | `serverId` | Yes | Unique workflow-MCP server identifier. | | `workflowId` | Yes | Workflow published as a tool on this server. | **Options** | Option | Required | Description | | ----------- | -------- | ----------------------- | | `-y, --yes` | Yes | Confirm this operation. | ### sim workflow-mcp-servers get [#sim-workflow-mcp-servers-get] Get Workflow MCP Server (OAuth login or personal API key required) ```bash sim workflow-mcp-servers get ``` **Arguments** | Argument | Required | Description | | ---------- | -------- | -------------------------------------- | | `serverId` | Yes | Unique workflow-MCP server identifier. | ### sim workflow-mcp-servers list [#sim-workflow-mcp-servers-list] List Workflow MCP Servers (OAuth login or personal API key required) ```bash sim workflow-mcp-servers list [options] ``` **Options** | Option | Required | Description | | ---------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--sort-by ` | No | Field used to sort the result. Sorting by `name` is case-sensitive and follows the storage collation, so do not rely on a case-insensitive order. Accepted values: `name`, `createdAt`, `updatedAt`. | | `--sort-order ` | No | Sort direction. Accepted values: `asc`, `desc`. | | `--limit ` | No | Maximum items to return (0 for everything). Defaults to `0`. | ### sim workflow-mcp-servers update [#sim-workflow-mcp-servers-update] Update Workflow MCP Server (OAuth login or personal API key required) ```bash sim workflow-mcp-servers update [options] ``` **Arguments** | Argument | Required | Description | | ---------- | -------- | -------------------------------------- | | `serverId` | Yes | Unique workflow-MCP server identifier. | **Options** | Option | Required | Description | | ----------------------- | -------- | ------------------------------------------------------------------------------------------------ | | `--name ` | No | Server display name, shown to connecting MCP clients. | | `--description ` | No | New server description, or null to clear it. (--description null sends the word, not JSON null). | | `--is-public` | No | Whether the server answers MCP clients without a Sim API key. | | `--no-is-public` | No | Send --is-public as false. | ## sim workflows [#sim-workflows] Also spelled `sim workflow`. ### sim workflows activate create [#sim-workflows-activate-create] Activate Workflow Version (OAuth login or personal API key required) ```bash sim workflows activate create [options] ``` **Arguments** | Argument | Required | Description | | ------------ | -------- | --------------------------- | | `workflowId` | Yes | Unique workflow identifier. | | `version` | Yes | Numeric deployment version. | **Options** | Option | Required | Description | | ----------- | -------- | ----------------------- | | `-y, --yes` | Yes | Confirm this operation. | ### sim workflows operations apply [#sim-workflows-operations-apply] Apply Workflow Operations (OAuth login or personal API key required) ```bash sim workflows operations apply [options] ``` **Arguments** | Argument | Required | Description | | ------------ | -------- | --------------------------- | | `workflowId` | Yes | Unique workflow identifier. | **Options** | Option | Required | Description | | ----------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--dry-run` | No | Validate and lint without persisting. The response is identical to the committed write of the same body, so a caller can inspect `lint` and then re-send the request for real. Nothing is written, no audit entry is recorded, and collaborators are not notified. | | `--no-dry-run` | No | Send --dry-run as false. | | `--operations ` | Yes | Edits to apply, in a single batch, keyed by operation\_type: \[\{"operation\_type":"add","block\_id":"my-fn","params":\{"type":"function","name":"My Fn","inputs":\{"code":"return \{ok:true}"}}},\{"operation\_type":"edit","block\_id":"\","params":\{"name":"Renamed","connections":\{"success":"my-fn"}}},\{"operation\_type":"delete","block\_id":"\"}]. Also extract\_from\_subflow, whose params carry \{"subflowId":"\"}, and insert\_into\_subflow, which creates a block and so takes an add’s params plus that subflowId (JSON, or @path / @- to read a file or stdin). | | `--atomic` | No | Fail the whole batch when any operation is declined or any block input would be dropped. The default applies what it can and reports the rest in `skipped` and `inputValidationErrors`; `true` writes nothing and answers `409` instead. | | `--no-atomic` | No | Send --atomic as false. | | `--layout ` | No | Whether to reposition blocks the batch touched. `targeted` (default) nudges only the affected subgraph; `none` leaves every position exactly as supplied. Accepted values: `targeted`, `none`. | | `--set-block-enabled ` | No | Blocks to enable or disable, applied after --operations: \[\{"block\_id":"\","enabled":false}]. Disabling a loop or parallel cascades to its unlocked descendants; enabling a block whose container is disabled is declined (JSON, or @path / @- to read a file or stdin). | | `-y, --yes` | No | Confirm this operation (required unless --dry-run). | ### sim workflows variables update [#sim-workflows-variables-update] Update Workflow Variables ```bash sim workflows variables update [options] ``` **Arguments** | Argument | Required | Description | | ------------ | -------- | --------------------------- | | `workflowId` | Yes | Unique workflow identifier. | **Options** | Option | Required | Description | | ---------------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--operations ` | Yes | Variable changes to apply in order, keyed by operation: \[\{"operation":"add","name":"my\_var","type":"string","value":"hello"},\{"operation":"edit","name":"my\_var","value":"updated"},\{"operation":"delete","name":"my\_var"}] (JSON, or @path / @- to read a file or stdin). | | `-y, --yes` | Yes | Confirm this operation. | ### sim workflows runs cancel [#sim-workflows-runs-cancel] Cancel a running workflow run ```bash sim workflows runs cancel [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ------------------------------- | | `runId` | Yes | Unique workflow run identifier. | **Options** | Option | Required | Description | | ------------------------- | -------- | ------------ | | `--workflow ` | Yes | Workflow ID. | ### sim workflows runs get [#sim-workflows-runs-get] Show run status (requested outputs are included in JSON or YAML output) ```bash sim workflows runs get [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ------------------------------- | | `runId` | Yes | Unique workflow run identifier. | **Options** | Option | Required | Description | | ---------------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--workflow ` | Yes | Workflow ID. | | `--include-output` | No | Include the final output in JSON or YAML output. | | `--select-output ` | No | Include blockId or blockId.path values in JSON or YAML output; block names are not resolved on a finished run (space-separated, or @path / @- with one value per line; @@value for a literal leading @). | | `--include-file-base64` | No | Inline each produced file's bytes as base64. Requires `includeOutput`. A file above the inline ceiling answers `413` naming its download path; fetch large files from `downloadPath` instead. | | `--no-include-file-base64` | No | Send --include-file-base64 as false. | | `--base64-max-bytes ` | No | Per-file inline ceiling, lowering but never raising the server limit of 16 MiB. | ### sim workflows runs list [#sim-workflows-runs-list] List runs for a workflow ```bash sim workflows runs list [options] ``` **Options** | Option | Required | Description | | ------------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--workflow ` | Yes | Workflow ID. | | `--status ` | No | Filter by run status. Accepted values: `pending`, `running`, `completed`, `failed`, `cancelled`, `paused`. | | `--trigger ` | No | Filter by trigger type. | | `--start-date ` | No | Only include runs started at or after this UTC ISO 8601 timestamp, e.g. `2026-08-06T00:00:00Z`. A date without a time, or a timestamp carrying a UTC offset instead of `Z`, is rejected, as is year `0000`, which names no storable instant. | | `--end-date ` | No | Only include runs started at or before this UTC ISO 8601 timestamp, e.g. `2026-08-06T00:00:00Z`. A date without a time, or a timestamp carrying a UTC offset instead of `Z`, is rejected, as is year `0000`, which names no storable instant. | | `--limit ` | No | Maximum items to return (0 for everything). Defaults to `100`. | | `--cursor ` | No | Continue from nextCursor returned by a previous result. | | `--order ` | No | Sort direction by run start time. This list is sortable only by run start time, so it takes `order` in place of `sortBy`/`sortOrder`, which it rejects. Accepted values: `asc`, `desc`. | ### sim workflows runs resume [#sim-workflows-runs-resume] Resume a paused run (output is included in JSON or YAML output) ```bash sim workflows runs resume [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ------------------------------- | | `runId` | Yes | Unique workflow run identifier. | **Options** | Option | Required | Description | | ------------------------- | -------- | ------------------------------------------------------------------- | | `--workflow ` | Yes | Workflow ID. | | `--context ` | Yes | Pause context ID returned by run status. | | `--input ` | No | Resume input as JSON (JSON, or @path / @- to read a file or stdin). | ### sim workflows runs wait [#sim-workflows-runs-wait] Wait for a run to reach a terminal state, then show it ```bash sim workflows runs wait [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ------------------------------- | | `runId` | Yes | Unique workflow run identifier. | **Options** | Option | Required | Description | | -------------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------- | | `--workflow ` | Yes | Workflow ID. | | `--wait-timeout ` | No | Give up after this many seconds, or 0 to wait indefinitely (default: 3600). Bounds the whole wait; SIM\_TIMEOUT\_SECONDS bounds one request. | ### sim workflows create [#sim-workflows-create] Create Workflow ```bash sim workflows create [options] ``` **Options** | Option | Required | Description | | ----------------------- | -------- | ----------------------------------------------------------- | | `--name ` | Yes | Workflow name. | | `--description ` | No | Optional workflow description. | | `--folder ` | No | Folder path as shown in the app; the leading / is optional. | ### sim workflows folders create [#sim-workflows-folders-create] Create a workflow folder at a path ```bash sim workflows folders create ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ---------------------------------------------------------- | | `path` | Yes | Folder path as shown in the app; the leading / is optional | ### sim workflows folders delete [#sim-workflows-folders-delete] Delete Workflow Folder ```bash sim workflows folders delete [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ---------------------------------------------------------- | | `path` | Yes | Folder path as shown in the app; the leading / is optional | **Options** | Option | Required | Description | | ------------- | -------- | -------------------------------------- | | `--recursive` | No | Delete the folder and its descendants. | | `-y, --yes` | Yes | Confirm this operation. | ### sim workflows folders list [#sim-workflows-folders-list] List workflow folders ```bash sim workflows folders list [options] ``` Also available as `sim workflows folders ls`. **Options** | Option | Required | Description | | ---------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--parent ` | No | Direct parent folder path. | | `--search ` | No | Case-insensitive substring match against the folder name. | | `--sort-by ` | No | Field used to sort the result. Sorting by `name` is case-sensitive and follows the storage collation, so do not rely on a case-insensitive order. Accepted values: `name`, `createdAt`, `updatedAt`. | | `--sort-order ` | No | Sort direction. Accepted values: `asc`, `desc`. | ### sim workflows folders move [#sim-workflows-folders-move] Rename or move a workflow folder ```bash sim workflows folders move ``` Also available as `sim workflows folders mv`. **Arguments** | Argument | Required | Description | | ------------- | -------- | ---------------------------------------------------------- | | `path` | Yes | Folder path as shown in the app; the leading / is optional | | `destination` | Yes | Folder path as shown in the app; the leading / is optional | ### sim workflows delete [#sim-workflows-delete] Delete Workflow ```bash sim workflows delete [options] ``` **Arguments** | Argument | Required | Description | | ------------ | -------- | --------------------------- | | `workflowId` | Yes | Unique workflow identifier. | **Options** | Option | Required | Description | | ----------- | -------- | ----------------------- | | `-y, --yes` | Yes | Confirm this operation. | ### sim workflows chat unpublish [#sim-workflows-chat-unpublish] Take a workflow’s chat deployment offline (OAuth login or personal API key required) ```bash sim workflows chat unpublish [options] ``` **Arguments** | Argument | Required | Description | | ------------ | -------- | --------------------------- | | `workflowId` | Yes | Unique workflow identifier. | **Options** | Option | Required | Description | | ----------- | -------- | ----------------------- | | `-y, --yes` | Yes | Confirm this operation. | ### sim workflows chat status [#sim-workflows-chat-status] Show a workflow’s chat deployment (OAuth login or personal API key required) ```bash sim workflows chat status ``` **Arguments** | Argument | Required | Description | | ------------ | -------- | --------------------------- | | `workflowId` | Yes | Unique workflow identifier. | ### sim workflows chat publish [#sim-workflows-chat-publish] Publish or replace a workflow’s chat deployment (OAuth login or personal API key required) ```bash sim workflows chat publish [options] ``` **Arguments** | Argument | Required | Description | | ------------ | -------- | --------------------------- | | `workflowId` | Yes | Unique workflow identifier. | **Options** | Option | Required | Description | | -------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `--identifier ` | Yes | URL slug the deployed chat answers on. Must be free across live deployments. | | `--title ` | Yes | Title shown to visitors. | | `--description ` | No | Description shown to visitors. Omitted clears it. | | `--customizations ` | No | Presentation overrides. Omitted fields take platform defaults. (JSON, or @path / @- to read a file or stdin). | | `--auth-type ` | No | How visitors are gated. `public` leaves the chat open to anyone holding the URL. Accepted values: `public`, `password`, `email`, `sso`. | | `--password ` | No | Write-only password. Required whenever `authType` is `password`, and rejected otherwise. Never readable back. | | `--allowed-emails ` | No | Email addresses or domains admitted under `email` and `sso` gating. At least one is required for those modes. (JSON, or @path / @- to read a file or stdin). | | `--output-configs ` | No | Block outputs to surface to visitors. Omitted surfaces none. (JSON, or @path / @- to read a file or stdin). | | `--include-thinking` | No | Allow visitors to receive provider thinking events. | | `--no-include-thinking` | No | Send --include-thinking as false. | | `--include-tool-calls` | No | Allow visitors to receive tool lifecycle events. | | `--no-include-tool-calls` | No | Send --include-tool-calls as false. | | `-y, --yes` | Yes | Confirm this operation. | ### sim workflows deploy [#sim-workflows-deploy] Deploy Workflow (OAuth login or personal API key required) ```bash sim workflows deploy [options] ``` **Arguments** | Argument | Required | Description | | ------------ | -------- | --------------------------- | | `workflowId` | Yes | Unique workflow identifier. | **Options** | Option | Required | Description | | ----------------------- | -------- | ------------------------------------------------- | | `--name ` | No | Optional label for the deployment version. | | `--description ` | No | Optional release note for the deployment version. | ### sim workflows duplicate create [#sim-workflows-duplicate-create] Duplicate Workflow ```bash sim workflows duplicate create [options] ``` **Arguments** | Argument | Required | Description | | ------------ | -------- | --------------------------- | | `workflowId` | Yes | Unique workflow identifier. | **Options** | Option | Required | Description | | ------------------ | -------- | ------------------------------------------------------------------------------- | | `--name ` | No | Name for the copy. Defaults to the source name, deduplicated within the folder. | | `--folder ` | No | Folder path as shown in the app; the leading / is optional. | ### sim workflows run [#sim-workflows-run] Run a deployed workflow or execute saved state manually ```bash sim workflows run [options] ``` **Arguments** | Argument | Required | Description | | ------------ | -------- | --------------------------- | | `workflowId` | Yes | Unique workflow identifier. | **Options** | Option | Required | Description | | ------------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--input ` | No | Trigger input as JSON (JSON, or @path / @- to read a file or stdin). | | `--async` | No | Queue the run and return immediately. | | `--execution-timeout-seconds ` | No | Maximum duration of an asynchronous run, in seconds, capped by the plan's execution timeout. Requires `async: true`; otherwise returns `400`. | | `--select-output ` | No | Return streamed outputs as blockName.path or childWorkflowId.blockName.path; selecting a child workflow applies to every invocation, requires --follow (space-separated, or @path / @- with one value per line; @@value for a literal leading @). | | `--include-file-base64` | No | Inline eligible output files as base64 content. Rejected when `async` is true. | | `--no-include-file-base64` | No | Send --include-file-base64 as false. | | `--base64-max-bytes ` | No | Maximum total bytes of file content to inline as base64, lowering but never raising the server limit of 16 MiB. Rejected when `async` is true. | | `--run-id ` | No | One-shot identifier for this run; NOT an idempotency key — reusing a claimed value fails with RUN\_ID\_CONFLICT instead of replaying the first result, and a fresh value starts another run. | | `--manual` | No | Run the current saved workflow state instead of the active deployment. | | `--trigger ` | No | Enter a manual run through this runnable trigger (requires --manual). | | `--mock-payload` | No | Use the selected trigger's server-derived mock payload (requires --manual). | | `--from-block ` | No | Run manually from this saved workflow block. | | `--source-run ` | No | Prior run whose persisted state supplies upstream outputs (requires --from-block). | | `--follow` | No | Stream the run as it happens; progress on stderr, result on stdout. The stream reports only success and output, so the result omits the run id and timings a non-streaming run returns. | | `--include-thinking` | No | Show model reasoning while following (requires --follow). | | `--include-tool-calls` | No | Show tool calls while following (requires --follow). | ### sim workflows export [#sim-workflows-export] Print a workflow as a portable JSON document ```bash sim workflows export ``` **Arguments** | Argument | Required | Description | | ------------ | -------- | --------------------------- | | `workflowId` | Yes | Unique workflow identifier. | ### sim workflows get [#sim-workflows-get] Get Workflow ```bash sim workflows get ``` **Arguments** | Argument | Required | Description | | ------------ | -------- | --------------------------- | | `workflowId` | Yes | Unique workflow identifier. | ### sim workflows deployment status [#sim-workflows-deployment-status] Show a workflow’s current deployment ```bash sim workflows deployment status ``` **Arguments** | Argument | Required | Description | | ------------ | -------- | --------------------------- | | `workflowId` | Yes | Unique workflow identifier. | ### sim workflows deployment update [#sim-workflows-deployment-update] Update Workflow Public API Access (OAuth login or personal API key required) ```bash sim workflows deployment update [options] ``` **Arguments** | Argument | Required | Description | | ------------ | -------- | --------------------------- | | `workflowId` | Yes | Unique workflow identifier. | **Options** | Option | Required | Description | | ------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------- | | `--is-public-api ` | Yes | Whether the deployed workflow should accept unauthenticated public API execution. Accepted values: `true`, `false`. | ### sim workflows state get [#sim-workflows-state-get] Get Workflow State ```bash sim workflows state get ``` **Arguments** | Argument | Required | Description | | ------------ | -------- | --------------------------- | | `workflowId` | Yes | Unique workflow identifier. | ### sim workflows state replace [#sim-workflows-state-replace] Replace Workflow State (OAuth login or personal API key required) ```bash sim workflows state replace [options] ``` **Arguments** | Argument | Required | Description | | ------------ | -------- | --------------------------- | | `workflowId` | Yes | Unique workflow identifier. | **Options** | Option | Required | Description | | --------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `--dry-run` | No | Validate and lint without persisting. The response is identical to the committed write of the same body, so a caller can inspect `lint` and then re-send the request for real. Nothing is written, no audit entry is recorded, and collaborators are not notified. | | `--no-dry-run` | No | Send --dry-run as false. | | `--blocks ` | Yes | Blocks keyed by block id. (JSON, or @path / @- to read a file or stdin). | | `--edges ` | Yes | Directed connections between blocks. (JSON, or @path / @- to read a file or stdin). | | `--loops ` | No | Ignored on write: loop containers are recomputed from `blocks`. (JSON, or @path / @- to read a file or stdin). | | `--parallels ` | No | Ignored on write: parallel containers are recomputed from `blocks`. (JSON, or @path / @- to read a file or stdin). | | `--variables ` | No | Replacement variable set. Omit to leave the stored variables untouched. (JSON, or @path / @- to read a file or stdin). | | `-y, --yes` | No | Confirm this operation (required unless --dry-run). | ### sim workflows versions get [#sim-workflows-versions-get] Get Workflow Version ```bash sim workflows versions get ``` **Arguments** | Argument | Required | Description | | ------------ | -------- | --------------------------- | | `workflowId` | Yes | Unique workflow identifier. | | `version` | Yes | Numeric deployment version. | ### sim workflows versions list [#sim-workflows-versions-list] List Workflow Versions ```bash sim workflows versions list [options] ``` **Arguments** | Argument | Required | Description | | ------------ | -------- | --------------------------- | | `workflowId` | Yes | Unique workflow identifier. | **Options** | Option | Required | Description | | ------------------ | -------- | -------------------------------------------------------------- | | `--limit ` | No | Maximum items to return (0 for everything). Defaults to `100`. | | `--cursor ` | No | Continue from nextCursor returned by a previous result. | ### sim workflows versions update [#sim-workflows-versions-update] Update Workflow Version ```bash sim workflows versions update [options] ``` **Arguments** | Argument | Required | Description | | ------------ | -------- | --------------------------- | | `workflowId` | Yes | Unique workflow identifier. | | `version` | Yes | Numeric deployment version. | **Options** | Option | Required | Description | | ----------------------- | -------- | --------------------------------------------------------------------------------------------------------------------- | | `--name ` | No | New label for the deployment version. | | `--description ` | No | New release note for the deployment version, or null to clear it. (--description null sends the word, not JSON null). | ### sim workflows import [#sim-workflows-import] Import Workflow ```bash sim workflows import [options] ``` **Options** | Option | Required | Description | | -------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------- | | `--workflow ` | Yes | Workflow export object, bare workflow state, or JSON string containing either form. (JSON, or @path / @- to read a file or stdin). | | `--folder ` | No | Folder path as shown in the app; the leading / is optional. | | `--name ` | No | Override for the imported workflow name. | | `--description ` | No | Override for the imported workflow description. | ### sim workflows list [#sim-workflows-list] List Workflows ```bash sim workflows list [options] ``` **Options** | Option | Required | Description | | ---------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--scope ` | No | Which lifecycle set to list: `active` (default) for live workflows, `archived` for workflows a `DELETE` archived. The folder filter resolves against active folders only, so pairing it with `archived` returns an empty page when the containing folder was archived too. Accepted values: `active`, `archived`. | | `--folder ` | No | Folder path as shown in the app; the leading / is optional. | | `--deployed-only` | No | Return only workflows with an active deployment when true. | | `--no-deployed-only` | No | Send --deployed-only as false. | | `--limit ` | No | Maximum items to return (0 for everything). Defaults to `0`. | | `--search ` | No | Case-insensitive substring match against the resource name. | | `--sort-by ` | No | Field used to sort the result. Sorting by `name` is case-sensitive and follows the storage collation, so do not rely on a case-insensitive order. Accepted values: `position`, `name`, `createdAt`, `updatedAt`, `runCount`. | | `--sort-order ` | No | Sort direction. Accepted values: `asc`, `desc`. | ### sim workflows move [#sim-workflows-move] Move Workflows ```bash sim workflows move [options] ``` **Options** | Option | Required | Description | | ----------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------- | | `--workflow ` | Yes | Workflows to move. Duplicates are collapsed. (space-separated, or @path / @- with one value per line; @@value for a literal leading @). | | `--to ` | Yes | Destination folder path; / moves the workflows to the workspace root. | ### sim workflows restore [#sim-workflows-restore] Restore an archived workflow ```bash sim workflows restore ``` **Arguments** | Argument | Required | Description | | ------------ | -------- | --------------------------- | | `workflowId` | Yes | Unique workflow identifier. | ### sim workflows revert create [#sim-workflows-revert-create] Revert Workflow To Version (OAuth login or personal API key required) ```bash sim workflows revert create [options] ``` **Arguments** | Argument | Required | Description | | ------------ | -------- | ----------------------------------------------------------------------- | | `workflowId` | Yes | Unique workflow identifier. | | `version` | Yes | Numeric deployment version, or `active` for the currently live version. | **Options** | Option | Required | Description | | ----------- | -------- | ----------------------- | | `-y, --yes` | Yes | Confirm this operation. | ### sim workflows rollback [#sim-workflows-rollback] Rollback Workflow (OAuth login or personal API key required) ```bash sim workflows rollback [options] ``` **Arguments** | Argument | Required | Description | | ------------ | -------- | --------------------------- | | `workflowId` | Yes | Unique workflow identifier. | **Options** | Option | Required | Description | | ---------------------- | -------- | ----------------------------------------------------------------------------- | | `--to-version ` | No | Deployment version to reactivate. Omit to select the previous active version. | | `-y, --yes` | Yes | Confirm this operation. | ### sim workflows undeploy [#sim-workflows-undeploy] Take a workflow out of deployment (OAuth login or personal API key required) ```bash sim workflows undeploy [options] ``` **Arguments** | Argument | Required | Description | | ------------ | -------- | --------------------------- | | `workflowId` | Yes | Unique workflow identifier. | **Options** | Option | Required | Description | | ----------- | -------- | ----------------------- | | `-y, --yes` | Yes | Confirm this operation. | ### sim workflows update [#sim-workflows-update] Update Workflow ```bash sim workflows update [options] ``` **Arguments** | Argument | Required | Description | | ------------ | -------- | --------------------------- | | `workflowId` | Yes | Unique workflow identifier. | **Options** | Option | Required | Description | | ----------------------- | -------- | ----------------------------------------------------------------------------------------------------- | | `--name ` | No | Replacement workflow name. | | `--description ` | No | Replacement workflow description; null clears it. (--description null sends the word, not JSON null). | | `--folder ` | No | Folder path as shown in the app; the leading / is optional. | ### sim workflows mv [#sim-workflows-mv] Move a workflow to a folder ```bash sim workflows mv ``` **Arguments** | Argument | Required | Description | | ------------ | -------- | ---------------------------------------------------------- | | `workflowId` | Yes | Unique workflow identifier. | | `folder` | Yes | Folder path as shown in the app; the leading / is optional | ### sim workflows ls [#sim-workflows-ls] List workflow resources and child folders together ```bash sim workflows ls [path] [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ------------------------------------------------ | | `path` | No | Folder path to list; defaults to the root folder | **Options** | Option | Required | Description | | ----------------- | -------- | --------------------------------------------------------------------- | | `--search ` | No | Filter folders and resources by name. | | `--limit ` | No | Maximum combined items to return (0 for everything). Defaults to `0`. | ### sim workflows mkdir [#sim-workflows-mkdir] Create a workflow directory at a path ```bash sim workflows mkdir ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ------------------------------------------------ | | `path` | Yes | Folder path to create; the leading / is optional | ## sim workspaces [#sim-workspaces] Also spelled `sim workspace`. ### sim workspaces get [#sim-workspaces-get] Get Workspace ```bash sim workspaces get ``` ### sim workspaces members [#sim-workspaces-members] List workspace members ```bash sim workspaces members [options] ``` **Options** | Option | Required | Description | | ------------- | -------- | ------------------------------------------------------------ | | `--limit ` | No | Maximum items to return (0 for everything). Defaults to `0`. | ### sim workspaces list [#sim-workspaces-list] List Workspaces ```bash sim workspaces list [options] ``` **Options** | Option | Required | Description | | ---------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--sort-by ` | No | Field used to sort the result. Sorting by `name` is case-sensitive and follows the storage collation, so do not rely on a case-insensitive order. Accepted values: `name`, `createdAt`, `updatedAt`. | | `--sort-order ` | No | Sort direction. Accepted values: `asc`, `desc`. | | `--limit ` | No | Maximum items to return (0 for everything). Defaults to `0`. |