Workato

Connect your Workato workspace by saving your own API Client Bearer token, after discovering which data center your workspace lives on and checking the token actually works there. Create the token in your workspace: Workspace admin -> API clients -> Create API client, assign it a role and project scope, then copy its token. No need to know your own data center -- it's discovered automatically.

Check whether Workato is currently connected (does not reveal the saved token).

Disconnect Workato: deletes the saved API Client token and data center. Existing recipes, connections and jobs in your own Workato workspace are not affected -- only Imperal's saved credential is removed.

List recipes (Workato's term for workflows) in the connected workspace -- name, running state, folder/project, trigger app, and lifetime job counts.

Read one Workato recipe in full -- its running state, trigger/action apps, folder/project, and lifetime job counts.

Create a brand-new, empty Workato recipe in a folder. You'll still need to build its trigger/action steps in the Workato recipe editor -- this creates the container, not a working automation.

Rename an existing Workato recipe.

Copy an existing Workato recipe -- same steps/logic, a new id and name, optionally into a different folder.

Permanently delete a Workato recipe. Cannot be undone.

Start (turn on) a Workato recipe so its trigger begins running.

Stop (turn off) a running Workato recipe.

Reset a recipe's trigger -- clears its stored polling/watermark state so the next run re-evaluates from scratch. Use after fixing a stuck trigger.

Force a Workato recipe to run right now, on demand, regardless of its trigger schedule. Executes real actions in your connected apps.

Activate a recipe's polling trigger immediately, instead of waiting for its next scheduled poll interval.

Update which connection a stopped recipe uses for one of its applications -- e.g. swap a Salesforce sandbox connection for production. The recipe must be stopped first.

List the saved version history of one Workato recipe.

Read one specific saved version of a Workato recipe in full.

Retrieve the most recent optimization/health analysis for a Workato recipe.

List the app connections in your Workato workspace -- what a recipe's trigger/action steps actually authenticate through.

Create a new connection in your Workato workspace -- the credential a recipe's steps authenticate through. Input fields are provider-specific (e.g. a Salesforce connection needs different fields than a Slack one).

Update an existing Workato connection's name and/or provider-specific input fields.

Disconnect a Workato connection (breaks its live authorization without deleting it). Recipes using it will fail until it's reconnected or replaced.

Permanently delete a Workato connection. Recipes using it will stop working once it's gone. Cannot be undone.

Get picklist values for a Workato connection -- the dropdown options a recipe step's field would show (e.g. valid Salesforce object names).

List past/current jobs (runs) for a Workato recipe -- status, timing, and whether each was a poll error.

Read one Workato job in full, including its run-time input/output data.

Re-run one or more Workato jobs with the same trigger inputs they originally received -- useful for retrying failed jobs after fixing the underlying issue.

List folders in your Workato workspace -- how recipes, connections and other assets are organized.

Read one Workato folder in full.

Create a new folder (or a top-level project, when parent_id is left empty and is_project is true) in your Workato workspace.

Rename a Workato folder.

Permanently delete a Workato folder. Cannot be undone.

List projects (top-level folders) in your Workato workspace.

Rename a Workato project.

Permanently delete a Workato project. Cannot be undone.

List tags defined in your Workato workspace.

Create a new tag in your Workato workspace.

Rename a Workato tag.

Permanently delete a tag from your Workato workspace. Assets keep working, they simply lose that tag.

Attach one or more tags to a Workato asset (recipe, connection, lookup table, etc).

Detach one or more tags from a Workato asset.

List lookup tables (key/value reference tables a recipe can read from) in your Workato workspace.

Create a new lookup table in your Workato workspace with the column schema you specify.

Permanently delete SEVERAL Workato lookup tables at once, by explicit ids. Cannot be undone.

List rows from a Workato lookup table, with optional column filtering and pagination.

Read one row from a Workato lookup table by its row id.

Add a new row to a Workato lookup table.

Update an existing row in a Workato lookup table.

Permanently delete one row from a Workato lookup table.

List environment properties defined in your Workato workspace, filtered by a key prefix (e.g. 'env.').

Create or update one or more environment properties in your Workato workspace. Existing keys are overwritten; new keys are created.

Clear Workato's own secrets management cache for the connected workspace -- forces fresh secret values to be re-read on next use.

View the assets (recipes, connections, lookup tables, etc.) in a Workato folder -- use this to build the asset list for an export manifest.

Create an export manifest -- a named container of specific Workato assets (recipes, connections, lookup tables) to later build into a deployable package.

Replace the asset list of an existing Workato export manifest.

Read one Workato export manifest in full -- its asset list and folder.

Permanently delete a Workato export manifest. This does not delete the underlying assets, only the manifest container.

Build a deployable package from an export manifest -- the actual source-code snapshot of every asset in it, at its latest version.

Import a previously exported package into a destination folder -- the same mechanism Workato's own environment promotion (dev -> production) uses under the hood.

Read one Workato package's status and metadata by id.

Get the signed download URL for a completed Workato package export.