TraceeDocs

Workflows

Create a workflow draft

A trigger and steps, saved as a draft; a person publishes and turns it on from the link in the answer. Give steps a key to read their output later as {{key.output.field}}.

POSThttps://traceeai.com/api/v1/workflows

CLI:tracee workflows create·MCP:workflowsaction create

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

Body

application/json
  • namestringrequired

    1–80 characters

  • triggerobjectrequired
  • stepsobject[]required

    Run in order

    up to 25 items

Response

Errors
  • 201Created.

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