TraceeDocs

Tools

workflows

Workflows

MCP tool

Automations in this workspace: a trigger (a schedule, a published post, a new CRM contact…) followed by steps in Tracee and connected apps (pick posts, publish, boost, update HubSpot, message Slack…), with branches and loops.

Actions

catalog

catalog [app]

Every trigger and action with its inputs and an example of its output. Call it before create or update. Connected apps (Slack, HubSpot, Gmail, Google Sheets, Notion, Salesforce, Pipedrive… hundreds of steps from Activepieces) are listed by app; pass app (e.g. ap_hubspot) for that app's steps in full.

RESTGET/workflows/catalog·CLItracee workflows catalog

list

The workspace's workflows.

RESTGET/workflows·CLItracee workflows list

get

get workflow_id

One workflow, step by step, with anything still missing.

RESTGET/workflows/{workflow_id}·CLItracee workflows get <workflow_id>

create

create name trigger steps

Build a new workflow and save it as a draft. Give steps a key to read their output later as {{key.output.field}}.

RESTPOST/workflows·CLItracee workflows create

update

update workflow_id [name] [trigger] [steps]

Replace the draft's name, trigger or steps (steps replace all steps; omit trigger to keep it).

RESTPATCH/workflows/{workflow_id}·CLItracee workflows update <workflow_id>

test

test workflow_id

A test run of the draft with sample data. Steps that write to other apps or publish are simulated.

RESTPOST/workflows/{workflow_id}/test·CLItracee workflows test <workflow_id>

Workflows you build stay drafts: a person reviews, publishes and turns them on from the link in the result. If an input is only the person's to decide (which channel, which list), leave it empty and ask them; the result lists what's missing.

Inputs

Every call takes action and the fields that action names above.

  • actionstringrequired

    What to do: catalog, list, get, create, update or test. Each is described in the tool description.

    Available options:cataloglistgetcreateupdatetest

  • appstring

    For catalog: one connected app's steps in full, e.g. ap_hubspot

    up to 60 characters

  • workflow_idstring

    For get, update, test; from action=list or create

    uuid

  • namestring

    For create (required) and update

    1–80 characters

  • triggerobject

    For create (required) and update

  • stepsobject[]

    For create (required) and update; run in order

    up to 25 items