Give Feedback

doctl harness-runtime list

Generated on 1 Oct 2026 from doctl version v1.177.0

Usage

doctl harness-runtime list [flags]

ls

List sessions visible to your team. Filter with --status, --name, or --parent-session-id. Paginate with --page-size and --page-token.

doctl harness-runtime list --page-size 10 --status SESSION_STATUS_READY;

Option	Description
`--format`	Columns for output in a comma-separated list. Possible values: `SessionID`, `Name`, `AgentKind`, `Status`, `ConfigID`, `ParentSessionID`, `ForkID`, `RepoHint`, `CreatedAt`, `PauseReason`.
`--help`, `-h`	Help for this command
`--name`	Filter by session name
`--no-header`	Return raw data with no headers Default: `false`
`--page-size`	Maximum number of sessions to return per page Default: `0`
`--page-token`	Pagination cursor from a previous list response
`--parent-session-id`	Filter to forked children of this parent session ID or name
`--paused-by`	Filter to paused sessions with this pause reason (zero-balance, idle, manual). Implies –status SESSION_STATUS_PAUSED. The API has no pause-reason filter, so this is applied to each returned page: a page can come back empty while later pages still hold matches.
`--status`	Filter by session status (e.g. SESSION_STATUS_READY, SESSION_STATUS_DESTROYED)

Command	Description
doctl harness-runtime	Managed Agents Runtime Services (M.A.R.S)

Option	Description
`--access-token`, `-t`	API V2 access token
`--api-url`, `-u`	Override default API endpoint
`--config`, `-c`	Specify a custom config file Default:
`--context`	Specify a custom authentication context name
`--http-retry-max`	Set maximum number of retries for requests that fail with a 429 or 500-level error Default: `5`
`--http-retry-wait-max`	Set the minimum number of seconds to wait before retrying a failed request Default: `30`
`--http-retry-wait-min`	Set the maximum number of seconds to wait before retrying a failed request Default: `1`
`--interactive`	Enable interactive behavior. Defaults to true if the terminal supports it (default false) Default: `false`
`--output`, `-o`	Desired output format [text\|json] Default: `text`
`--trace`	Show a log of network activity while performing a command Default: `false`
`--verbose`, `-v`	Enable verbose output Default: `false`