List compliant version selection audit events

get

{protocol}://{host}:{port}/xray/api/v1/curation/audit/compliant-versions

List Compliant Version Selection (CVS) audit events. Each event is one
CVS pass against a curated repository, with the packages that were
inspected.

Requires a user who can view curation policies.

created_at on each event is epoch milliseconds. Pass that value as
created_at on the version-detail endpoint.

include_versions defaults to false. Packages are always returned.
Each package's versions array is empty unless include_versions=true.
Policies inlined on the listing have empty explanation and
remediation. The version-detail endpoint returns those fields.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

order_by

string

enum

Defaults to id

Column to sort by. Only id is allowed. Default: id.

Allowed:

direction

string

enum

Defaults to desc

Sorting direction: asc or desc.

Allowed:

num_of_rows

integer

1 to 2000

Defaults to 100

Maximum number of events. Valid range: 1-2000.

offset

integer

Defaults to 0

Pagination offset.

include_versions

boolean

Defaults to false

When true, each package includes its inspected versions and the policies that hit them. Default false.

include_total

boolean

Defaults to false

Include total_count in the response metadata.

created_at_start

date-time

Start of the time range (RFC 3339). If omitted, defaults to 7 days before created_at_end. The range cannot exceed 7 days.

created_at_end

date-time

End of the time range (RFC 3339). If omitted, defaults to 7 days after created_at_start, or to now when both bounds are omitted. Must be after created_at_start.

package_type

string

Exact package type.

package_name

string

Exact package name.

package_version

string

Exact package version.

curated_repo_name

string

Exact curated repository name.

inspection_results

string

enum

Per-package CVS outcome.

Allowed:

reason

string

enum

Version-level reason. Matching is case-insensitive.

Allowed:

Responses

Language

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200CVS audit events.

400Invalid pagination or created_at parameters.

500Failed to fetch CVS audit events.