ti fs delete-layer

Abandons a layer without erasing its history. If the layer has live descendants, the command fails unless you specify --cascade, which abandons the descendants first.

Syntax

ti fs delete-layer
  --layer-ref <string>
  [--cascade]
  [--dry-run]
  [--file-system-id <string>]
  [--fs-token <string>]
  [--help]
  [--version]

Options

• --layer-ref <string>: Layer ID, unique name, or tag reference. [required]
• --cascade: Abandon live descendants before abandoning the selected layer.
• --dry-run: Validate the request without applying changes.
• --file-system-id <string>: Select the file system. You can also set TI_FS_FILE_SYSTEM_ID.
• --fs-token <string>: Set the Filesystem token. If omitted, the command uses the TI_FS_TOKEN environment variable. If neither is provided, the command uses the local token stored for the selected Filesystem.
• --help: Display help information.
• --version: Display version information.

For options shared by all commands, see Global options.

Examples

• Abandon a rejected leaf timeline:

  # Deletion fails when the selected layer still has live descendants.
  ti fs delete-layer --file-system-id <file-system-id> --layer-ref experiment-a
  

• Abandon a test-owned subtree:

  # Cascade is explicit and abandons descendants before the selected layer.
  ti fs delete-layer --file-system-id <file-system-id> --layer-ref experiment-root --cascade
  

Related documentation

• TiDB Cloud Filesystem CLI Command Reference
• ti fs list-layer-chain