pi workspace list
Command Help
> pi ws list -h
Usage: pi workspace list [-h] [--format {csv,json,long,table} | --verbose]
[--model MODEL] [--contains IP [IP ...]]
[--match-substring MATCH_SUBSTRING]
[--creator CREATOR [CREATOR ...]] [--all]
[--limit LIMIT] [--query QUERY] [--squery SQUERY]
Description: List all matching Workspaces. A variety of format and filtering
options are supported.
Optional arguments:
--format {csv,json,long,table}
Return the results using the specified data structure.
Default value is "table".
--limit LIMIT Limit the output to the specified number of records
--match-substring MATCH_SUBSTRING, -m MATCH_SUBSTRING
Filter by matching substring. All fields in the output
are considered
--model MODEL Use the specified report model (table report only).
--query QUERY, -q QUERY
Filter using the Perforce IPLM Query Language.
--squery SQUERY, -sq SQUERY
Filter using a Saved Perforce IPLM Query.
--verbose, -v Alias for --format long.
-h, --help Show this help message and exit
Filters:
--all, -a Include all Workspaces without filtering by creator
(shows only Workspace created by the current user
otherwise).
--contains IP [IP ...]
Filter by Workspace that contains the IP, Line or IPV.
Matches against list of resources in the workspace as
well as top IPV.
--creator CREATOR [CREATOR ...]
Filter by Workspace creator.
More information and documentation available at:
https://help.perforce.com/methodics/
Copyright © 2010-2025 Perforce, Inc.
Examples
> pi ws list ┌───────────────────────────┬────────────┬───────────────────────────────┬─────────────────────┐ │ TOP IPV │ CREATED BY │ CREATED ON │ PATH │ ╞═══════════════════════════╪════════════╪═══════════════════════════════╪═════════════════════╡ │ tutorial.tutorial@6.TRUNK │ admin │ 2019-07-29 17:03:37 -0700 PDT │ /tmp/workspaces/ws1 │ │ tutorial.tutorial@5.TRUNK │ admin │ 2019-07-24 12:43:49 -0700 PDT │ /tmp/workspace/ws1 │ └───────────────────────────┴────────────┴───────────────────────────────┴─────────────────────┘ Found 2 matching object(s).