2026
Notable changes to the Celigo developer platform across the REST API, CLI, and Platform MCP.
CLI 2026.8.8
@celigo/celigo-cli 2026.8.8 is on npm.
npm install -g @celigo/celigo-cliNew:
exports reset-cursor <id>resets the CDC cursor on a stream (Debezium) export — the platform deletes the stored offset and restarts the stream consumer, no flow toggle required. The server refuses a reset while the savedcdc.snapshotModeisinitial_only;--snapshot-mode when_neededflips the mode and resets in the same save, re-arming a one-shot snapshot export without cloning and deleting it. The save is fail-soft (HTTP 200 either way): the CLI reads the_cursorResetStatusverdict and exits non-zero on refusal. See exports.Fixed:
mcp-serversnow calls/v1/mcpservers(lowercase), exactly as the API reference documents. Reads were never affected, but writes through the undocumented camelCase path could leave a live MCP server serving a staletools/listfor 15+ minutes after Tool schema edits. If you script against the REST API directly, use the documented lowercase path. See mcp-servers.
AU and CA data centers
Data and tokens never cross a region boundary, so each region needs its own token and base URL.
REST API base URLs
https://api.au.integrator.io(AU) andhttps://api.ca.integrator.io(CA) join the existing US and EU hosts. Sign in atau.integrator.ioorca.integrator.io. See Environments & regions.Platform MCP answers at
https://api.au.integrator.io/celigo-mcpandhttps://api.ca.integrator.io/celigo-mcp. OAuth sign-in routes to the tenant that matches the endpoint you configure. See Connect a client.The CLI targets a region through a profile's base URL:
celigo profile add au --api-token "$AU_TOKEN" --api-base-url https://api.au.integrator.io. See Profiles & regions.AU data stays in Australia and CA data stays in Canada, the same in-region residency the EU data center provides.
CLI 2026.8.7
@celigo/celigo-cli 2026.8.7 is on npm: 34 new commands across end-user management, MCP server access, documentation search, product feedback, and API request logging.
npm install -g @celigo/celigo-cliBreaking and renamed
Breaking:
subscriptions usagereturns one combined object covering account, API, entitlement, historical monthly, EDI label-printing, storage, and syncs usage; license-gated sources appear inline as{"error": ...}entries. Anything parsing the old bare output should pipe--jq .usage, which returns exactly the previous payload. See subscriptions.usersis nowworkspace-users: your team's account collaborators, distinct from the newend-users— external people who sign in to use your MCP servers.usersis retained as a hidden alias, so existing invocations keep working.
End-user management
end-usersmanages external MCP end users:list(with--provisioned-by invite|jit),effective-accessfor one user's compiled MCP access with each grant's source,invite --email(one address, or up to 100 per call), andrevoke. Invitations send real emails.groupsandrolesbundle MCP grants for assignment: standard CRUD, plusgroups add-members/remove-members.mcp-servers effective-access <id>lists every end user who can reach a server and their effective tools.assign-end-usersandassign-groupsbulk-assign a server's capabilities (tool:,api:, andpset:capability-set handles) to up to 100 targets per call; an assignment replaces each listed target's grant for that server. See mcp-servers.
Docs search and feedback
docs searchasks Celigo's product documentation a question and returns an AI-generated answer with cited sources.--threadcontinues a conversation. Allowed in read mode.feedback submitsends structured product feedback (--category,--severity,--command,--expected,--actual), with the CLI version and runtime context attached automatically — never command arguments or payload data. Works in every mode, andfeedback submit --helpincludes a worked incident-report example.
API Builder request logging
apis request-history <id>lists an API's logged request executions — recorded whilelogging.modeis anything butno_logging— with time, status-code, method, trace-key-prefix, remote-IP, and URI filters.apis execution-logs <apiId> <executionId>prints one execution's trace;--detailsadds decoded step payloads, fan-out children, and payload download URLs.apis delete-execution-logsqueues deletion of a date range.apis setapplieslogging.mode,logging.debugUntil, andtraceKeyTemplateatomically viaPATCH— the server ignoresloggingon a fullPUT. See apis.
Also in this release
tools invoke <id>runs a Tool synchronously;--log-mode debugrecords the run.tools clonecopies a Tool into a target integration — Tools that reference connections require aconnectionMap. See tools.storage get <ids...>fetches metadata for up to 100 files in one call,storage movemoves up to 100 items (--namerenames a single item as it moves), andstorage cancel-uploadaborts a stuck multipart upload. See storage.http-connectors catalogandhttp-connectors endpoint-detailread the staged form-metadata summaries and scoped detail documents. See http-connectors.integrations register-lookup-cachesandderegister-lookup-cachesattach and detach lookup caches. Registering also writes analiases[]entry, which must be removed before deregistering. See integrations.flows get --merge-instancereturns an instance flow's effective config, andflows listadds--name,--disabled,--include-instances,--abstract-flow-id, and--sort-by lastExecutedAt. See flows.
Full command reference in the Celigo CLI section.
August API updates
Everything below is live in production and documented in the API reference.
End-user management joins the reference: End Users, Groups, and Roles cover listing end users, compiling one user's effective MCP access, single and bulk invites (up to 100 addresses), revocation, group membership, and role CRUD.
MCP servers document
permissionSets[]— embedded capability sets (accessLevel: read|write,_toolIds,_apiIds) referenced in grants aspset:<_id>— plus per-server effective access and bulk capability assignment to end users or groups, up to 100 per call. See MCP Servers.MCP server
prompts[]entries document their server-generated_id.Tool invocation documents the
x-log-modeheader: onlydebugtakes effect on a direct call;basic,standard, anddetailedapply when an AI agent or MCP server invokes the Tool.Integrations document the lookup-cache registration endpoints' alias side effect: registering writes an
aliases[]entry per cache, and deregistering fails with400until the alias is removed.Corrections to the APIs spec: mapping
dataTypeis documented as required,hardCodedValuecasing is fixed, andloggingis writable only viaPATCH— the server ignores it onPUT.
CLI 2026.8.2
@celigo/celigo-cli 2026.8.2 is on npm and includes everything in 2026.8.1.
npm install -g @celigo/celigo-cliRenamed and removed options
Breaking: date and time options now name the field they bound, as
--*-gteand--*-lte.audit listandscripts debug-logstake--time-gteand--time-lte,edi-transactions listtakes--modified-gteand--modified-lte, andflows delete-execution-logstakes--started-gteand--started-lte. The former names no longer resolve.Breaking:
flows runtakes--start-timeand--end-timefor a delta window override, replacing--start-dateand--end-date. The window accepts a full timestamp, which the former names read as a calendar date.Breaking:
--sandboxis removed fromjobs current,jobs run-stats, andedi-transactions list. The environment comes from the profile's token, so use a profile that targets the Sandbox environment.tp-connectorsis nowtrading-partner-connectors. The former name is retained as an alias, so existing scripts keep working. See trading-partner-connectors.
Projected list output
listrequests server-side field projection by default. Each row carries_id,name, and the group's table columns instead of the complete document. On one accountexports listwent from 12.9 MB to 183 KB, andflows listmeasured 7.5× smaller.Table output and
getare unchanged.jobs,sync-jobs,recycle-bin,storage,audit, the error listings, andaccount snapshotare never projected.--fields allreturns complete documents.--fields defaultnames the built-in projection explicitly.--fields <a,b,c>requests a specific set, with dot notation for nested fields.An explicit
--fieldslist is a floor, not an exact shape._idandnameaccompany every projection, as does any field the command filters on internally.--jqfetches complete documents on its own, so existingjqpipelines are unaffected. Precedence is--fields, then--jq, then the profile'slist_fields, then the built-in default. Pairing--jqwith an explicit--fieldsprojects, and the expression can read anull. See Global flags.celigo config set list_fields allmakes complete documents the default for a profile. The key is per-profile and acceptsallordefault. See Configuration reference.--limit <n>returns at most<n>rows from a single page. It is available on the standardlistverb.ai-agents,guardrails,notifications,stacks,http-connectors,trading-partner-connectors, andtemplates marketplaceaccept--fieldswithout it.
New command groups
celigo storagemanages files and folders in Celigo Storage:list,search,upload,download,replace,create-folder,set,move,copy,merge, anddelete. See storage.celigo datasetsselects which tables or objects a sync replicates, withlist,get, and batchupsert.datasets available <connectionId>anddatasets fields <connectionId> <datasetName>read the source catalog. See datasets.celigo processorsruns the stateless parsers and generators:list,invoke <name>,parse <csv|edi|xml>, andgenerate <csv|edi>. Nothing on the account is created or changed, so these run in aread-mode profile. See processors.
Syncs
syncsaddslist(with--integration),get,create,update,set, anddeletebeside the existingrun,audit, andcancel-jobs. See syncs.syncs events <syncId>lists schema drift and data catalog events, filtered by--type,--resource-name,--run, or a time range.syncs usagereports records loaded per sync, per month with entitlement history, or per environment.
AI assistant skills
The CLI installs the official Celigo skills in a detached background process, at most once every 24 hours, so an AI assistant driving the CLI has them without a manual step. It never blocks or fails the command that triggered it, and is skipped in CI. See AI assistant skills.
The background process installs only when the
celigo/aiskills repository has moved since the last install. When it has not, the CLI installs nothing and prints nothing.celigo skills install,celigo skills list, andceligo skills updaterun the installer on demand. Nothing is installed at npm install time.Opt out with
CELIGO_NO_SKILLS_INSTALL=1orceligo config set skills_auto_install false.celigo config set skills_auto_install_exclude writing-sql,writing-handlebarskeeps named skills out of the background install, which then requests the rest by name instead of--all. An explicitceligo skills installignores the list.auto_update,skills_auto_install, andskills_auto_install_excludeare machine-wide, stored outside the profiles rather than on one of them.
Also in this release
flows error-summarymakes one request to the per-step rollup endpoint instead of one request per flow step, and reports each step'slastErrorAt. ThestepTypecolumn is gone — the rollup does not return it.apis downloadandtools downloadsave a builder-mode API or a Tool as a template.zip. The API archive includes every resource it references; script-mode APIs cannot be exported.apis clone --dry-runvalidates the target version and route without creating anything.audit listandaudit downloadaccept multiple--resource-type,--source, and--actionvalues, plus--resource <type>:<id>pairs. Each filter matches any of its values. See audit.storage merge <id> --to <destinationId>merges one folder into another and removes the source. Requiresfullmode.JSON output is compact when stdout is a pipe or a file, and pretty-printed only at an interactive terminal.
mcp-oauth-providersguards masked credentials the wayconnectionsandiclientsdo.setrefuses every field on the group, which has noPATCHwhitelist, and points atupdatewith the real values.Commands behind a confirmation prompt exit
1when there is no TTY, instead of exiting0after refusing to act.The background self-update names the exact command it runs, so the notice is auditable.
celigo config set auto_update falsedowngrades it to a notify-only hint;CELIGO_NO_UPDATE=1disables the check entirely.
Full command reference in the Celigo CLI section.
OAuth sign-in for Platform MCP
Add the Platform MCP endpoint to your client with no credentials and it opens a browser sign-in — no more creating and copying API tokens. Per-client setup in Connect a client.
{
"mcpServers": {
"celigo": {
"url": "https://api.integrator.io/celigo-mcp"
}
}
}The server implements OAuth 2.1 with PKCE and dynamic client registration. Clients that follow the MCP authorization spec discover the sign-in automatically — current releases of Claude, Cursor, VS Code, Windsurf, and ChatGPT all do.
Sign-in uses your Celigo credentials, including SSO and MFA where your account requires them. The session acts as you, in the account and environment you pick at sign-in.
Clients refresh the session automatically. You sign in again only if access is revoked, you switch account or environment, or the session goes unused for an extended period.
API tokens and personal access tokens still work for CI, scripts, and clients without OAuth support — pass one in the
Authorizationheader, same as before.The endpoint is region-specific:
https://api.eu.integrator.io/celigo-mcpsigns in againsteu.integrator.io. To switch account or environment, disconnect the server and sign in again.
Personal access tokens
A personal access token (PAT) is a bearer token you create yourself that acts with your own user permissions — no admin provisioning, no scopes. Full details in Authentication.
Create one under Resources → API tokens → + Generate token → Personal access token. Manage and Monitor roles get self-service API access for the first time; for them it is the only token type offered.
The token inherits your permissions and follows role changes. Disabling your user blocks the token; deleting your user revokes it.
Admins can see and revoke every PAT on the account, but cannot view a token value they didn't create.
PATs auto-purge after 90 days by default, configurable from 1 hour to never.
A PAT works anywhere an API token works: REST API calls,
CELIGO_API_TOKENin the CLI, and theAuthorizationheader on Platform MCP.
Platform MCP: nine new tools
Connected clients pick these up automatically — the catalog is fetched at runtime. Full details in Tools.
B2B EDI
list_edi_profiles/upsert_edi_profilemanage trading-partner interchange envelopes (X12 ISA/GS, EDIFACT UNB).list_file_definitions/upsert_file_definitionmanage parsing and generation rules for CSV, fixed-width, X12, and EDIFACT files.list_edi_transactionsqueries the EDI transaction log by document type, direction, document number, or date window;includeFaDetails/includeMdnadd acknowledgment detail.update_edi_fa_statusmarks acknowledgmentsacceptedorrejectedin bulk.
Marketplace and debugging
list_marketplacebrowses published templates or previews one template's full blueprint;deploy_templateinstalls it as a new integration mapped to your connections.list_execution_logsreads a run's debug logs: the index, one record's step timeline, or request/response payloads per stage. Requires debug logging armed on the flow.
Existing tools
list_flow_errorswith no arguments returns an account-wide summary of every erroring flow and step.list_flowsaddshasOpenErrors,includeErrorCounts, andnumError_gte.run_flowtakes optional overrides:export.startDate/export.endDatefor backfills,_exportIdsto run a subset of source exports.list_jobswithincludeFiles: truereturns short-lived download URLs for files a run produced.
Fixes
Every tool declares MCP tool annotations (read-only, destructive, idempotent).
run_flowandcancel_jobtake_id, matching every other tool (previouslyid).update_flow_error_retry_dataadvertises the correct body schema — the retry-data envelope, not the flow schema.list_lookup_cache_datadrops a straybodyparameter.delete_resourcestates that its dependency pre-flight runs for connections only and that warnings never block the delete;resourceTypeaddsedi-profilesandfile-definitions.list_environmentsreturns an empty list with a warning on accounts without the feature.list_jobsreturns[]instead ofnullwhen nothing matches.
July API updates
Everything below is live in production and documented in the API reference.
AI agents
AI agent and guardrail imports support Anthropic Claude: set
provider: "anthropic"with a Claude model id inlitellm.modeland Claude settings inlitellm._overrides.anthropic(requiredsystemInstruction, extended thinking viathinkingConfig, Claude tools including web search).temperatureis capped at 1 andresponseFormat.typemust betextorjson_schema.All three providers accept a
resourcesarray — read-only reference content (policies, schemas, documentation) pinned from connected MCP servers.OpenAI reasoning effort adds
noneandxhigh; OpenAI configs supporttopLogprobs; the LiteLLMmaxCompletionTokensdefault rose from 1000 to 5000.
Endpoints
The Syncs reference now covers the full build surface, not just running and monitoring: sync CRUD, dataset CRUD, schema-drift events, source and destination metadata catalogs, and usage endpoints.
POST /v1/connectionsaccepts__integrationIds(up to 100) to create a connection and register it on integrations in one call; post-save registration failures are reported in__failedIntegrationRegistrationswithout rolling back the connection.The step error endpoints (
GET /v1/flows/{_id}/{_stepId}/errorsand.../resolved) add filters:_flowJobId(paired withoccurredAt_gteorresolvedAt_gte), occurred/resolved date bounds,tags(includinguntagged), andresolvedBy(includingauto).GET /v1/apis/{_id}/templateandGET /v1/tools/{_id}/templateexport a builder-mode API or Tool and everything it references as an installable.zipvia a short-lived signed URL.POST /v1/apis/{_id}/clone/validatedry-runs a clone and returnscanClone, catching version/route conflicts before anything is created.MCP servers (the
mcpserversresource) accept aresourcesarray: Celigo Storage files served to MCP clients throughresources/listandresources/read.
Also in the reference
Integration clone previews include Tool resources; the
tools_not_supportedrejection is gone.The recycle bin supports the
storageitemsresource type (list-only).License responses document
storageentitlements (maxAllowedUsage,disableOverage) and EDIlabelPrintingentitlements.Trading-partner connectors carry new
type(FTP,AS2,S3) andregionfields.
Celigo Platform MCP is generally available
The Celigo Platform MCP is now live at https://api.integrator.io/celigo-mcp. It's a hosted remote MCP endpoint that lets AI agents read, run, and troubleshoot your integrator.io account: no local process, no sidecar, a bearer token and any MCP-compatible client.
Who it's for
Anyone working with AI coding agents: Claude Code, Claude Desktop, Cursor, VS Code with Copilot, Windsurf, or any client that speaks Streamable HTTP. Point the client at the endpoint, hand it an API token, and the agent can operate on your integrator.io account directly.
What agents can do today
Inspect everything. List and get connections, integrations, flows, exports, imports, scripts, agents, guardrails, APIs, tools, MCP servers, lookup caches, iClients, jobs, and audit entries.
Build and edit resources. Create or update any resource with a single
upsert_*tool, and delete any resource withdelete_resource, which reports dependents as advisory warnings but doesn't block. A masked-credential guard keeps agents from overwriting stored secrets.Run flows and triage errors. Trigger a flow, wait for the job, inspect per-step results, then retry, resolve, tag, or assign failed records, all in one conversation.
Use built-in prompts. Guided workflows ship with the server: account health audits, flow troubleshooting, connection diagnosis, integration planning, flow config review, and Handlebars/SQL writing assistance. The
search_knowledge_basetool answers product questions straight from the Celigo Knowledge Base.Load reference resources. The server exposes a product glossary, tool usage guide, error pattern reference, connector catalog, and API reference as MCP resources: context the agent pulls on demand. (Full connector and resource schemas come from the
get_schematool, not a resource.)
Get started
{
"mcpServers": {
"celigo": {
"url": "https://api.integrator.io/celigo-mcp",
"headers": {
"Authorization": "Bearer <YOUR_API_TOKEN>"
}
}
}
}Full setup, authentication details, transport options, and the complete tool catalog live in the Platform MCP section.
CLI 2026.6.1
@celigo/celigo-cli 2026.6.1 is on npm. A large release: seven new command groups, file-based input across every write command, credential-safe set, actionable error hints, and a round of command renames that align the CLI surface.
npm install -g @celigo/celigo-cliNew command groups
celigo connectors: base CRUD plusinstall-base,install,push-update, andconnectors licensesCRUD.celigo state: read and write resource and account state withlist,get,set,delete,purge. Global by default; scope to a resource with--resource-typeand--resource-id.celigo syncs:run,audit,sources,destinations,cancel-jobs.celigo sync-jobs:list(auto-paginated per sync, newest first, with--created-gte/--created-lte),get,errors,cancel.celigo recycle-bin:list,get,restore(with--cascade),purge.celigo mcp-oauth-providers: full CRUD for MCP OAuth providers.celigo event-reports:list,get,create,signed-url,cancel.
New subcommands on existing groups
HTTP connectors:
create,update,delete,resources,resource,endpoints,endpoint.Templates:
templates installto install from a local.zipor by id with a connection map, pluslist,get,create,update,delete.EDI transactions:
fa-detail,mdn-detail,update-fa-status,download-file --document-type.APIs:
set-group/unset-group, pluscreate-api-group/delete-api-group/api-groups.Flows:
error-summary,delete-execution-logs --started-at --end-at,cancel-jobs,set-group/unset-group.Connections:
applications(external apps in use, filterable with--application),delete-debug-logs,purge-messages.Scripts:
audit,delete-debug-logs.Tools and partners:
tools connections,tp-connectors create/update/delete.Across resources:
dependencies(aliasused-by),audit,profile whoami,on-premise-agents installer-url --os,notifications list,stacks audit,users enable/disable,environments enable/disable.
File-based input
-f, --file <path> now works on every create, update, and install command (--file - still means stdin). And set accepts file://<path> assignment values to load multi-line content such as script source or SQL without escaping:
celigo exports create -f ./export.json
celigo scripts set 64a... content=file://./transform.jsThis avoids shell input redirection, which is unreliable when driven by an agent and unsupported in PowerShell.
Credential-safe writes
setuses atomic JSON-Patch whitelists. Whitelisted fields PATCH cleanly; masked-credential endpoints (connections, iClients) refuse non-whitelisted edits rather than round-tripping a GET then PUT that would wipe stored secrets.updaterefuses payloads that still contain the masked******placeholder unless you pass--force.profile deletenow confirms before deleting (-y, --yesto skip).
Better errors
Actionable hints mapped from API error codes (
inactive_flow,feature_not_enabled,invalid_ref,access_restricted) now appear in the formatted error.Empty required positional arguments are rejected up front, catching unset shell variables like
celigo jobs get "$ID"before they hit the API blind.--limitis validated as a positive integer instead of silently coercing bad input.
Renamed and restructured commands
account depsis nowaccount dependencies.<resource> debug-enable/debug-disableare nowenable-debug/disable-debug.exports/importstest-run-stepis nowtest-run-step-results.flows flow-group-createis nowcreate-flow-group;flow-group-assignis nowset-group(with a newunset-group).flows execution-logs-enable/-disableare nowenable-execution-logs/disable-execution-logs.flows execution-log-queryis nowquery-execution-logs;execution-log-datais nowexecution-log-detail.integrations snapshotis nowcreate-snapshot;integrations filesplusdownloadare nowdownload-files.agents/scriptslogsis nowdebug-logs.usage historicalis nowhistorical-usage.Token verbs consolidated:
system-token/display-tokentotoken;recycle-token/change-tokentorotate-token.Error commands now take explicit ids:
resolve-errorsis nowerror(flow, step, and error ids passed as arguments),error-analyzeis nowerror-analysis,update-error-datatakes the error id explicitly, andassign-errorsgained an explicit step argument.Templates:
templates list(marketplace) is nowtemplates marketplace;invokeandpreviewtake an optional id.The interactive REPL was removed; running
celigowith no arguments no longer opens a shell.The
account-infogroup was removed; itsapplicationslisting is nowconnections applications.
Fixes and internals
connections purge-messagestreats the API's "queue already empty"404 Not Foundas a successful no-op.usersandenvironmentsenable/disableread current state before toggling, so the verbs are honest and idempotent.account dependenciesorphaned-script detection walks_scriptIdreferences recursively, catching flow-level and nested refs.New
createdAtcursor pagination with a truncation warning when the safety cap is hit (used bysync-jobs list).The account index staleness window tightened from 4 hours to 15 minutes.
All 124 bundled skill schemas re-synced from the platform's published API specs, the drift check is now line-ending tolerant, and the legacy
rest/simpleschemas were removed (useHTTPExport/HTTPImportinstead).
CLI 2026.4.5 — generally available
@celigo/celigo-cli 2026.4.5 is now generally available on npm. This is the launch release: a first-party command-line tool for driving integrator.io from your terminal, your scripts, your CI pipelines, and the AI coding agents you already work with.
Who it's for
Developers and AI coding agents who live in a terminal. If the integrator.io UI is the right tool for your day-to-day, keep using it — the CLI exists for the workflows where a UI slows you down: scripted bulk edits, version-controlled configuration, CI checks, and long-horizon agents that need to read and write live integrator.io state without burning context on a GUI.
What you can do
Drive every resource. Anything in the REST API maps to a
celigo <resource> <verb>command — integrations, flows, connections, exports, imports, scripts, agents, guardrails, EDI profiles, on-premise agents, and more.Manage multiple accounts. Profiles switch between prod, sandbox, and EU regions without juggling tokens.
celigo profile use euis the whole context switch.Lint your account.
celigo account lintruns static analysis across integrations, flows, and scripts — broken references, missing required fields, common script errors — before you push to production.Snapshot, search, diff.
celigo account snapshotpulls every resource into a local index for full-text search (celigo account search), dependency graphs (celigo account deps), and per-resource stats.Pipe-friendly output. Every command supports
--format json|yaml|table|csvand--jq, so results flow cleanly into shell scripts and other tools.
AI assistant skills, included
Installing the CLI globally also installs a set of AI assistant skills for Claude Code, Cursor, and Windsurf — domain-specific guides plus OpenAPI-derived schemas the assistant loads on demand. Ask "build a Shopify → NetSuite flow" and the assistant pulls the building-flows skill and writes JSON that actually validates against integrator.io, instead of guessing field names. Skills update atomically when you upgrade the CLI.
Get started
npm install -g @celigo/celigo-cli
celigo profile add prod --api-token "$CELIGO_API_TOKEN"
celigo integrations list --format tableFull install options, profile setup, region targeting, and skills coverage live in the CLI section.
Last updated
Was this helpful?