Skip to content

List remediation targets

GET
/v1/remediation-targets

Returns a paginated list of remediation targets in the organization.

limit
integer
default: 50 >= 1 <= 100

Maximum number of targets to return.

offset
integer
0

Number of targets to skip for pagination.

endpointId
string format: uuid

Filter by endpoint ID.

targetType
string
Allowed values: software os_patch configuration service

Filter by target type.

status
string
Allowed values: active stale resolved

Filter by target status.

Paginated list of remediation targets.

object
data
required
Data

The list of remediation targets.

Array<object>
Remediation Target

An actionable remediation target discovered on an endpoint.

object
id
required
ID

Unique identifier for the remediation target.

string format: uuid
endpoint_id
required
Endpoint ID

The endpoint where this target was discovered.

string format: uuid
nullable
target_type
required
Target Type

The type of remediation target.

string
Allowed values: software os_patch configuration service
vendor
Vendor

The vendor of the target (e.g., software vendor).

string
nullable
product
Product

The product name of the target.

string
nullable
version
Version

The version of the target.

string
nullable
install_path
Install Path

The installation path (for software targets).

string
nullable
package_name
Package Name

The package name (for package manager targets).

string
nullable
package_manager
Package Manager

The package manager (e.g., “brew”, “apt”, “winget”).

string
nullable
status
required
Status

The lifecycle status of the remediation target.

string
Allowed values: active stale resolved
source
required
Source

The source that discovered this target.

string
associated_cves
required
Associated CVEs

List of CVE identifiers associated with this target.

Array<string>
highest_cvss_score
required
Highest CVSS Score

The highest CVSS score of the associated CVEs (0-10).

number
nullable <= 10
created_at
required
Created At

When this target was created.

string format: date-time
updated_at
required
Updated At

When this target was last updated.

string format: date-time
total
required
Total

Total number of targets matching the filters.

integer
limit
required
Limit

Page size used.

integer
offset
required
Offset

Offset used.

integer

Missing or invalid API key.

object
error
required

Human-readable error message.

string

Internal server error.

object
error
required

Human-readable error message.

string