---
title: "Remove Workflow Node"
method: DELETE
path: "/v1/workflows/{workflow_id}/nodes/{node_id}"
tags: ["API v1", "Workflows", "Workflow Nodes"]
---

# Remove Workflow Node

`DELETE /v1/workflows/{workflow_id}/nodes/{node_id}`

## Request

- Base URL: `https://api.xpander.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.xpander.ai/v1/workflows/{workflow_id}/nodes/{node_id}`
- Auth: API key in header `x-api-key`

Remove a node from a workflow and scrub any edges that pointed to it.

## Path parameters

- `workflow_id` string, required
- `node_id` string, required

## Query parameters

- `deploy` boolean: Deploy the workflow after removing so the change takes effect immediately.

## Response `200`

Successful Response

- WorkflowNodeView[]
  - `id` string, required: Node id (use to update/remove the node).
  - `type` string, required: Node type (action, agent, classifier, ...).
  - `name` string, nullable: Node name.
  - `next_node_ids` string[]: Ids of nodes that run after this one.
  - `asset_id` string, nullable: Referenced asset id for action/agent nodes.
  - `connection_id` string, nullable: Connection id parsed from an action node's asset_id.
  - `operation_id` string, nullable: Operation catalog id parsed from an action node's asset_id.
  - `target_agent_id` string, nullable: Agent id for agent nodes.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/xpander/apis/xpander-ai-api-service.md) - [All operations](https://skmtc.dev/xpander/apis/xpander-ai-api-service/llms.txt) - [OpenAPI document](https://skmtc.dev/xpander/apis/xpander-ai-api-service/revisions/725c0066d5df?raw)