Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.plerion.com/llms.txt

Use this file to discover all available pages before exploring further.

With plerion risks, you can view and filter security risks identified by Plerion, including severity, lifecycle state, and related asset details.
For more about risks in the Plerion dashboard, see Top risks.

​
Synopsis

plerion risks list [options]

​
Subcommands

​
list

List security risks with filtering and sorting. 
plerion risks list [options]

​
Options

FlagTypeDescription
--idsstringFilter by risk IDs (comma-separated)
--risk-type-idstringFilter by risk type IDs (comma-separated)
--primary-asset-idstringFilter by primary asset IDs (comma-separated)
--severitystringCRITICAL, HIGH, MEDIUM, LOW
--lifecycle-statestringOPEN, DISMISSED_ACCEPTED, DISMISSED_NOT_A_RISK
--integration-idstringFilter by integration
--environment-idstringFilter by environment
--resource-typestringFilter by resource type
--includestringLoad relationships: primaryAsset, integration
--fieldsstringSelect specific fields to return (comma-separated)
--discovered-at-startstringDiscovered at start date (ISO 8601)
--discovered-at-endstringDiscovered at end date (ISO 8601)
--sort-bystringdiscoveredAt or score
--sort-orderstringasc or desc
--per-pagenumberResults per page (default: 50)
--allflagFetch all pages automatically

​
Examples

# Critical risks sorted by score
plerion risks list --severity CRITICAL --sort-by score --sort-order desc

# Open risks with asset details
plerion risks list --lifecycle-state OPEN --include primaryAsset

# Risks for a specific integration
plerion risks list --integration-id int-abc123 --output json

# Fetch all risks across all pages
plerion risks list --all --output json

​
Output columns

Table output includes all fields returned by the API:
ColumnDescription
IDRisk ID
TYPERisk type ID
SEVERITYCRITICAL, HIGH, MEDIUM, LOW
SCORENumeric risk score
LIKELIHOODLikelihood rating
IMPACTImpact rating
STATELifecycle state (OPEN, DISMISSED_ACCEPTED, DISMISSED_NOT_A_RISK)
DESCRIPTIONRisk description
PRIMARY ASSET IDPrimary affected asset ID
ASSET NAMEPrimary asset name
RESOURCE TYPEResource type
FULL RESOURCE NAMEFull resource name
REGIONCloud region
INTEGRATION IDIntegration ID
TENANT IDTenant ID
ORG IDOrganization ID
DISCOVERED ATDiscovery timestamp