Workflows

Workflow triggers and steps

Every trigger and action with its inputs and an example output. Pass app (e.g. ap_hubspot) for one connected app's steps in full.

GEThttps://traceeai.com/api/v1/workflows/catalog

CLI:tracee workflows catalog·MCP:workflowsaction catalog

Authorizations

Authorizationstringheaderrequired
Bearer <key>: a personal key (tracee login or Settings → Personal keys), a workspace key, or an MCP client's OAuth token. See Authentication.

Headers

Tracee-Workspacestring
For a personal key or OAuth token that reaches several workspaces: the workspace id to act on. Workspace keys don't need it.
uuid

Query parameters

appstring
One connected app's steps in full, e.g. ap_hubspot
up to 60 characters

Response

Errors

200Done.
The action's result, exactly as the MCP tool returns it to agents. A next field, when present, names the endpoint that follows up.

{ "apps": [ { "app": "ap_slack", "name": "Slack", "steps": 69, "triggers": 0, "note": "Connected through the workspace's Slack connection. action=catalog app=ap_slack lists every step." }, { "app": "ap_hubspot", "name": "HubSpot", "steps": 54, "triggers": 24, "note": "Connected through the workspace's HubSpot connection. action=catalog app=ap_hubspot lists every step." }, { "app": "ap_salesforce", "name": "Salesforce", "steps": 104, "triggers": 9, "note": "Connected through the workspace's Salesforce connection. action=catalog app=ap_salesforce lists every step." } ], "references": "Text inputs and conditions can read earlier output: {{trigger.output.field}}, or {{key.output.field}} for a step you gave a key (the saved flow shows it as {{step_N.output.field}}). Inside a loop the current item is {{loop_key.output.item}}. Paths take dots and [index].", "operators": [ "TEXT_CONTAINS", "TEXT_DOES_NOT_CONTAIN", "TEXT_EXACTLY_MATCHES" ], "triggers": [ { "piece": "schedule", "trigger": "every_week", "title": "Every week", "description": "Runs on the chosen days at a set time.", "inputs": { "days": { "type": "STATIC_MULTI_SELECT_DROPDOWN", "required": true, "options": [ "MON", "TUE", "WED" ], "default": [ "TUE", "THU" ] }, "time": { "type": "SHORT_TEXT", "required": true, "default": "09:00" }, "timezone": { "type": "STATIC_DROPDOWN", "required": true, "options": [ "UTC", "America/New_York", "America/Chicago" ], "default": "UTC" } }, "output_example": "{\"scheduledAt\":\"2026-11-11T22:33:23.854Z\"}" }, { "piece": "schedule", "trigger": "every_day", "title": "Every day", "description": "Runs once a day at a set time.", "inputs": { "time": { "type": "SHORT_TEXT", "required": true, "default": "09:00" }, "timezone": { "type": "STATIC_DROPDOWN", "required": true, "options": [ "UTC", "America/New_York", "America/Chicago" ], "default": "UTC" }, "weekdays_only": { "type": "CHECKBOX", "required": false, "default": true } }, "output_example": "{\"scheduledAt\":\"2026-11-11T22:33:23.854Z\"}" }, { "piece": "schedule", "trigger": "manual", "title": "Run manually", "description": "Runs when someone presses Run.", "inputs": {}, "output_example": "{\"startedBy\":\"you\"}" } ], "actions": [ { "piece": "tracee", "action": "inbox_draft_reply", "title": "Draft an inbox reply", "description": "Tracey writes a reply in your voice and leaves it in the conversation for a person to send.", "writes": true, "inputs": { "thread_id": { "type": "SHORT_TEXT", "required": true, "description": "The conversation from \"New inbox message\"." }, "instruction": { "type": "LONG_TEXT", "required": false } }, "output_example": "{\"threadId\":\"thread_yg2b7js7\",\"draft\":\"Thanks Priya! For a team of six it's the Growth plan. Happy to walk you through it, want me to send a demo link?\",\"alternatives\":[{\"label\":\"Short and warm\",\"text\":\"Thanks Priya! I'll DM you the details.\"}]}" }, { "piece": "tracee", "action": "inbox_reply", "title": "Reply in the inbox", "description": "Sends a reply to the conversation. Your approval rules still apply.", "writes": true, "inputs": { "thread_id": { "type": "SHORT_TEXT", "required": true, "description": "The conversation from \"New inbox message\"." }, "text": { "type": "LONG_TEXT", "required": true }, "close": { "type": "CHECKBOX", "required": false, "default": false } }, "output_example": "{\"threadId\":\"thread_sdiadgf1\",\"status\":\"pending_approval\"}" }, { "piece": "tracee", "action": "inbox_close", "title": "Close a conversation", "description": "Marks an inbox conversation as handled.", "writes": true, "inputs": { "thread_id": { "type": "SHORT_TEXT", "required": true } }, "output_example": "{\"threadId\":\"thread_ylo3sf1f\",\"status\":\"done\"}" } ] }