workflow_approve

Managementcatalog

Approve Workflow Node

Not in the default tool list

This tool lives in the tool catalog. Discover it with scenario_tools_search (or enumerate everything with scenario_tools_list) and run it via scenario_tool_execute_write. To list every tool directly, connect with ?toolsets=full.

Approve a pending human-approval node in a running workflow. Args: - workflow_id: required - workflow_job_id: required — the workflow job awaiting approval - node_id: required — the gate node to approve - team_id, project_id: required for OAuth callers Returns: { job } — the run's compact job row (the same fields as job_get's) after the approval; when the run waits at a later step, awaiting_input and awaiting_input_hint sit beside job. Example: "Approve this workflow node" -> workflow_id="workflow_xxx", workflow_job_id="job_xxx", node_id="node_xxx" Don't use when: the paused step is a selection step (user-selection node, the run waits for a pick of candidates) — use workflow_select.

open-world

Parameters

Name	Type	Required	Description
workflow_id	string	✓	Workflow ID.
workflow_job_id	string	✓	Job ID.
node_id	string	✓	Node ID.
team_id	string	—	Team ID. Required with project_id for OAuth callers; an API key is scoped by the key.
project_id	string	—	Project ID. Required with team_id for OAuth callers; an API key is scoped by the key.
response_format	enum(json \| markdown)	json	Output format: 'json' for structured data, 'markdown' for human-readable text.

Example Request

JSON

{
  "workflow_id": "wf_hero_pipeline",
  "workflow_job_id": "job_wf_001",
  "node_id": "node_review_001",
  "team_id": "team_abc123",
  "project_id": "proj_xyz789"
}

Example Response

JSON

{
  "workflow": {
    "id": "wf_hero_pipeline",
    "status": "running"
  }
}

Common Use Cases

Approve a human-in-the-loop node in a paused workflow
Resume a paused workflow after reviewing intermediate results