Update Workspace Subgraph
update_workspace_subgraphUpdate a subgraph's name and member nodes by replacing the entire steps array. Resolve subgraph by ID or name using local cache or repo path.
Instructions
Update a subgraph's name and member nodes. Replaces the entire steps array. Pass either subgraphID (fastest) or subgraphName — if only the name is given, the ID is resolved from (1) the local UUID cache, (2) {repoPath}/subgraphs/*.yml. The public Coalesce API has no subgraph list endpoint, so a subgraph created outside this MCP session cannot be resolved by name without a repo checkout.
Args:
workspaceID (string, required): The workspace ID
subgraphID (string, optional): The subgraph ID. Preferred when known.
subgraphName (string, optional): The subgraph name. Used to resolve the ID when subgraphID is absent.
repoPath (string, optional): Coalesce repo path for subgraph YAML lookup.
name (string, required): Updated name
steps (string[], required): Updated node IDs
Returns: { subgraphID, subgraph, resolvedFrom } where resolvedFrom is "input" | "cache" | "repo".
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Updated name for the subgraph | |
| steps | Yes | Updated array of node IDs to include in the subgraph | |
| repoPath | No | Optional Coalesce repo path for subgraph YAML lookup. Falls back to COALESCE_REPO_PATH or the coa profile. | |
| subgraphID | No | The subgraph ID. Preferred when known — fastest path. | |
| workspaceID | Yes | The workspace ID | |
| subgraphName | No | The subgraph name. Used to resolve the ID from the local cache or repo subgraphs/ folder when subgraphID is absent (the Coalesce API has no subgraph list endpoint). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | ||
| name | No | ||
| message | No |