Detach (remove) a layer or content reference from an artifact.

Usage

para detach <artifact> [target] [options]

Arguments

Options

Description

Removes a layer definition or content reference from an artifact file. The target can be a layer name, instructions, or agent-instructions.

If no target is provided, you will be prompted to select from all available layers and content references interactively. In non-interactive mode (-y), the target argument is required.

The artifact file is rewritten in its original format (JSON or YAML) after removal. If the last layer is removed, the layers object is removed from the artifact entirely.

Examples

Detach a specific layer:

para detach my-form.yaml pdf

Detach instructions:

para detach my-form.yaml instructions

Detach agent instructions:

para detach my-form.yaml agent-instructions

Interactive selection (layers + content references):

para detach my-form.yaml

Preview changes without modifying:

para detach my-form.yaml pdf --dry-run

Skip confirmation:

para detach my-form.yaml instructions -y

Output

When detaching a layer:

Layer to remove:
  layers.pdf:
    kind: file
    path: ./lease-template.pdf
    mimeType: application/pdf

Detached layer "pdf" from: my-form.yaml

When detaching a content reference:

Content reference to remove:
  instructions:
    kind: file
    path: ./instructions.md
    mimeType: text/markdown

Detached content reference "instructions" from: my-form.yaml

See also

• attach - Attach files to artifacts
• show - Display artifact content