Remove relation

Remove a relation from the source file.

Command relation.remove. Writes files in the working tree, never to Git. It is refused while the workspace is read-only. Changes an element file, and no change can be checked against a missing or faulty metamodel.

Input

Field	Type	Required	Description
source	elementRef	yes	UUID, short ID or identifier (e.g. SR-036), any case; several matches give ref.ambiguous.
kind	key	yes	Fixed metamodel key of a type, property, relation kind or status value. Readable English, lower case, dashes (D-043, SR-010 AK2).
target	elementRef	yes	UUID, short ID or identifier (e.g. SR-036), any case; several matches give ref.ambiguous.
repository	string	no	Only relations into this repository (workspace name); a relation that names none points into the source’s repository (D-058). Names the one meant when a UUID has relations into several repositories.

Output

Field	Type	Required	Description
files	array of string	yes
problems	array of problem	no

App

In the command prompt (Ctrl+Shift+P, macOS ⌘⇧P): the command Remove relation.

CLI

reqseq relation remove, with --json for the output as JSON. Its help:

Usage: reqseq relation remove <source> <kind> <target> [options]

Remove a relation from the source file.

Options:
  --source <value>        instead of the argument <source>
  --kind <value>          instead of the argument <kind>
  --target <value>        instead of the argument <target>
  --repository <value>    Only relations into this repository (workspace name);
                          a relation that names none points into the source's
                          repository (D-058). Names the one meant when a UUID
                          has relations into several repositories.
  --input <json|@file|->  command input as JSON: inline, from a file, or from
                          standard input
  --workspace <path>      workspace root (default: nearest folder upwards with
                          reqseq-workspace.yaml)
  --json                  print exactly the command output as JSON
  --yaml                  print the whole command output as YAML, problems one
                          per line
  -h, --help              show help

API

POST /v1/commands/relation.remove on the local API (reqseq serve api), with the input as the JSON body; the answer is the output.

MCP

Tool relation_remove of the MCP server (reqseq mcp), with the input as its arguments.