TraceeDocs

Workflows

Change a workflow draft

Replace its name, trigger or steps (steps replace all steps).

PATCHhttps://traceeai.com/api/v1/workflows/{workflow_id}

CLI:tracee workflows update·MCP:workflowsaction update

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

Path parameters

  • workflow_idstringrequired

    From GET /api/v1/workflows or create

    uuid

Body

application/json
  • namestring

    1–80 characters

  • triggerobject
  • stepsobject[]

    Run in order

    up to 25 items

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.