sp workspace

Phase: v2
When agents use this: Manage or export interface cases from the console filesystem model (optional for record-driven replay workflows).

Synopsis

Workspace filesystem: folders, interfaces, cases, import/export.

Subcommands (representative)

Subcommand	REST area
list / tree	Query workspace items
case query	POST /api/filesystem/queryCase
case save	POST /api/filesystem/saveCase
interface query	POST /api/filesystem/queryInterface
export	POST /api/filesystem/export
import	POST /api/filesystem/import
env list	POST /api/environment/queryEnvsByWorkspace

Examples

sp workspace tree --workspace-id ws-1 --json
sp workspace case query --case-id case-1 --json
sp workspace export --item-id item-1 --out-dir .sp-work --json

Agent guidance

Prefer record-driven replay (sp replay run from production traffic) unless the skill explicitly manages manual cases in a workspace.

REST mapping

Base: /api/filesystem/*, /api/environment/*, /api/label/*

See API mapping for the full FileSystemController surface.

Related

• concepts