> For the complete documentation index, see [llms.txt](https://developer.celigo.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.celigo.com/cli/commands.md). # Command reference Every `celigo` command, one page each. Most resource commands share the same shape, so once you know one you know them all. ## The common shape | Subcommand | What it does | | ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `list` | List the resources. Add `--integration ` where supported to scope to one integration. | | `get ` | Fetch one resource by ID. | | `create` | Create from a JSON body. Read it from a file with `-f, --file ` (recommended) or pipe it on stdin. | | `update ` | Full replace from a JSON body (`--file` or stdin). Pass `--force` to submit a body that still holds the masked `******` credential placeholder — since celigo-cli 2026.10.1, a value of four or more asterisks and nothing else. | | `set key=value …` | Targeted field edit. Whitelisted fields apply via an atomic `PATCH`; others round-trip GET, modify, PUT. Load a field from a file with `key=file://`. Each group has its own whitelist, and since celigo-cli 2026.10.1 ` set --help` names it. | | `delete ` | Delete by ID (`-y` to skip the prompt). | | `dependencies ` | List what references the resource, so you know if it is safe to delete. | | `audit ` | Show the change history for one resource. | Individual commands add their own subcommands on top of this (for example `flows run`, `flows test-run`, `connections ping`, `jobs diagnostics`). Every command accepts the [global flags](/cli/getting-started/global-flags.md). > File-based input (`-f, --file ` on `create` / `update`, and `key=file://` on `set`) shipped in celigo-cli 2026.6.1. It avoids shell escaping and works the same in bash and PowerShell. > > Since celigo-cli 2026.10.1, `create`, `update`, and `set` check the body against the published API schemas before sending it: a finding prints on stderr as a warning, and the request is still sent. ## The local tree Seven bare verbs work on the account as a file tree instead of one resource at a time. They are documented in [The local tree](/cli/local-tree.md). | Command | Purpose | | ------------------------------------------------------------- | ------------------------------------------------------------------------ | | [pull](/cli/local-tree/pull.md) | Download the account, or one integration, as a local file tree. | | [status](/cli/local-tree/status-and-diff.md#celigo-status) | List local changes since the last pull. Offline. | | [diff](/cli/local-tree/status-and-diff.md#celigo-diff) | Compare the tree with the live account, field by field. | | [push](/cli/local-tree/push.md) | Write local changes back, plan first. | | [lint](/cli/local-tree/lint-and-resolve.md#celigo-lint) | Validate the tree against the platform's published API schemas. Offline. | | [resolve](/cli/local-tree/lint-and-resolve.md#celigo-resolve) | Resolve a link, path, `type:id`, or id to the document's path. Offline. | | [promote](/cli/local-tree/promote.md) | Write the tree into another account or environment. | ## All commands | Command | Purpose | | ------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | | [account](/cli/commands/account.md) | Account-wide operations: snapshot, search, dependencies, lint, stats. | | [ai-agents](/cli/commands/ai-agents.md) | Manage AI agents (LLM-powered import steps). | | [alerts](/cli/commands/alerts.md) | Manage proactive alerts (long-runtime thresholds that notify recipients when a flow runs too long). | | [apis](/cli/commands/apis.md) | Manage API endpoints (builder and script modes). | | [async-helpers](/cli/commands/async-helpers.md) | Manage async helpers (polling configs for long-running API operations). | | [audit](/cli/commands/audit.md) | View audit logs. | | [config](/cli/commands/config.md) | Manage CLI configuration. | | [connections](/cli/commands/connections.md) | Manage connections (credentials and configuration for external systems). | | [connectors](/cli/commands/connectors.md) | Manage connectors (installable integration applications). | | [datasets](/cli/commands/datasets.md) | Choose which source tables and objects a sync replicates, and how. | | [docs](/cli/commands/docs.md) | Search Celigo's product documentation: AI answers with cited source articles. | | [edi-profiles](/cli/commands/edi-profiles.md) | Manage EDI document profiles for trading partners. | | [edi-transactions](/cli/commands/edi-transactions.md) | Query EDI transaction logs from the B2B Manager dashboard. | | [end-users](/cli/commands/end-users.md) | Manage end users (external MCP users): list, effective access, invite, revoke. | | [environments](/cli/commands/environments.md) | Manage environments (isolated spaces within an account). | | [event-reports](/cli/commands/event-reports.md) | Manage event reports. | | [exports](/cli/commands/exports.md) | Manage exports (data sources that read from external systems). | | [feedback](/cli/commands/feedback.md) | Send product feedback about the CLI or platform — works in every mode, including read. | | [file-definitions](/cli/commands/file-definitions.md) | Manage file format definitions (CSV, EDI, fixed-width, etc.). | | [file-definition-rules](/cli/commands/file-definition-rules.md) | Generate EDI file definition rules from a specification PDF (X12 or EDIFACT). | | [file-server](/cli/commands/file-server.md) | Manage the environment's Celigo-hosted SFTP file server and its partner accounts. | | [flows](/cli/commands/flows.md) | Manage flows (data pipelines connecting exports to imports). | | [groups](/cli/commands/groups.md) | Manage end-user access groups (bundled roles and MCP grants; add/remove members). | | [guardrails](/cli/commands/guardrails.md) | Manage guardrails (PII detection, content moderation, AI safety checks). | | [http-connectors](/cli/commands/http-connectors.md) | Browse and manage HTTP connector definitions. | | [http-connector-resources](/cli/commands/http-connector-resources.md) | Manage your own HTTP connector resources (the API groupings inside a custom connector). | | [http-connector-endpoints](/cli/commands/http-connector-endpoints.md) | Manage your own HTTP connector endpoints (the method + URI operations under a custom connector's resources). | | [iclients](/cli/commands/iclients.md) | Manage OAuth2 iClients (app registrations for OAuth flows). | | [imports](/cli/commands/imports.md) | Manage imports (data destinations that write to external systems). | | [integrations](/cli/commands/integrations.md) | Manage integrations (containers for flows, connections, and resources). | | [jobs](/cli/commands/jobs.md) | Manage flow execution jobs (status, files, diagnostics, cancellation). | | [login](/cli/commands/login.md) | Sign in to integrator.io with OAuth — the alternative to an API token. | | [logout](/cli/commands/logout.md) | Sign a profile out: revoke its OAuth session and remove the stored tokens. | | [lookup-caches](/cli/commands/lookup-caches.md) | Manage lookup caches (in-memory key-value stores for enrichment and deduplication). | | [mcp-oauth-providers](/cli/commands/mcp-oauth-providers.md) | Manage MCP OAuth providers for MCP servers. | | [mcp-servers](/cli/commands/mcp-servers.md) | Manage MCP servers that expose tools and APIs as MCP endpoints. | | [metadata](/cli/commands/metadata.md) | Query metadata via a live connection (NetSuite, Salesforce, RDBMS). | | [network-policies](/cli/commands/network-policies.md) | Manage network policies (IP allow and deny lists for API tokens, MCP servers, and sign-in). | | [notifications](/cli/commands/notifications.md) | Manage notification subscriptions (integrations, flows, connections). | | [on-premise-agents](/cli/commands/on-premise-agents.md) | Manage on-premise agents (OPA). | | [platform](/cli/commands/platform.md) | GET any API path the command groups do not cover, with the profile's token. | | [processors](/cli/commands/processors.md) | Parse and generate CSV, XML, and EDI text without touching account state. | | [profile](/cli/commands/profile.md) | Manage named config profiles (multiple accounts and environments). | | [recycle-bin](/cli/commands/recycle-bin.md) | Browse and restore soft-deleted resources. | | [roles](/cli/commands/roles.md) | Manage end-user roles (named, reusable sets of MCP-server grants). | | [scripts](/cli/commands/scripts.md) | Manage scripts (JavaScript hooks: preSavePage, preMap, postMap, postSubmit). | | [stacks](/cli/commands/stacks.md) | Manage stacks (server and Lambda runtimes for custom code). | | [state](/cli/commands/state.md) | Manage state key-value stores. | | [storage](/cli/commands/storage.md) | Manage files and folders in Celigo Storage. | | [subscriptions](/cli/commands/subscriptions.md) | View subscription and usage information. | | [sync-jobs](/cli/commands/sync-jobs.md) | Inspect and cancel sync jobs (the executions produced by `syncs run`). | | [syncs](/cli/commands/syncs.md) | Manage and run syncs — Celigo Data Ingestion replication pipelines. | | [tags](/cli/commands/tags.md) | Manage tags for organizing resources. | | [templates](/cli/commands/templates.md) | Browse, preview, manage, and install integration templates. | | [topics](/cli/commands/topics.md) | Manage Event Streams topics (durable message channels): CRUD, retained messages, publish, purge, listener offsets. | | [tools](/cli/commands/tools.md) | Manage tools (reusable building blocks callable from flows, APIs, agents, and MCP servers). | | [trading-partner-connectors](/cli/commands/trading-partner-connectors.md) | Browse trading partner connector definitions. Aliased as `tp-connectors`. | | [workspace-users](/cli/commands/workspace-users.md) | Manage workspace users (your team's account collaborators) and their access levels. Formerly `users`, which still works as a hidden alias. |