v1

latestOpenAPI 3.0.32026-07-262499981.2 MB
SemgrepRuleService

ListSemgrepRules

Lists all Semgrep rules in the namespace.

get/v1/namespaces/{tenant_meta.namespace}/semgrep-rules

Path parameters

tenant_meta.namespacestring required

Namespaces are a way to organize organizational units into virtual groupings of resources. Namespaces must be a fully qualified name, for example, the child namespace of namespace "endor.prod" called "app" is called "endor.prod.app".

Query parameters

list_parameters.filterstring

String of conditions to filter resources by. Filters may include any attribute along with the following operators: "==", "!=", ">", ">=", "<", "<=", "Contains", "In", "Matches", and "Exists". The logical operators "And" and "Or" are also supported. Expressions may be combined and grouped with parentheses.

Examples: "spec.value == 5", "spec.value in ["a", "b", "c"]", "(meta.name == "xyz" and "spec.value in ["a","b"]) or (spec.value == "c")".

list_parameters.page_tokeninteger

Set the page token to start from. Use page tokens to page through list results or list specific pages.

list_parameters.page_sizeinteger

Set the page size to limit the number of results returned. Default: 100. Max: 500.

list_parameters.actionstring

Action to be executed with a request. Not supported for all endpoints.

list_parameters.maskstring

List of fields to return (all fields are returned by default).

list_parameters.traverseboolean

Get data from any child namespaces as well.

list_parameters.sort.pathstring

Field to sort objects by, for example, meta.name.

list_parameters.sort.order'SORT_ENTRY_ORDER_UNSPECIFIED' | 'SORT_ENTRY_ORDER_ASC' | 'SORT_ENTRY_ORDER_DESC'

Sort order. Default: ASC.

list_parameters.countboolean

Return the number of objects matching the given list parameters. If count is set to true, the response is a CountResponse. Can be used together with filter and traverse.

list_parameters.group.aggregation_pathsstring

Group the objects based on this field. If there are multiple fields then the objects are grouped based on the uniqueness of all fields. Supports composite paths. Supports arrays and maps.

list_parameters.group.show_aggregation_uuidsboolean

Return the UUID of each object in each group as specified by aggregation_paths.

list_parameters.group.unique_count_pathsstring

List of fields for which we want the unique count. Supports arrays and maps.

list_parameters.group.unique_value_pathsstring

List of fields for which we want the unique values. Supports arrays and maps.

list_parameters.ci_run_uuidstring

Only return objects from PR scans that match this context id.

list_parameters.page_idstring

Page ID to retrieve.

list_parameters.group_by_time.aggregation_pathsstring

Group the objects based on this time field, for example, meta.create_time.

list_parameters.group_by_time.show_aggregation_uuidsboolean

Return the UUIDs of the objects in each group.

list_parameters.group_by_time.interval'GROUP_BY_TIME_INTERVAL_UNSPECIFIED' | 'GROUP_BY_TIME_INTERVAL_YEAR' | 'GROUP_BY_TIME_INTERVAL_QUARTER' | 'GROUP_BY_TIME_INTERVAL_MONTH' | 'GROUP_BY_TIME_INTERVAL_WEEK' | 'GROUP_BY_TIME_INTERVAL_DAY' | 'GROUP_BY_TIME_INTERVAL_HOUR' | 'GROUP_BY_TIME_INTERVAL_MINUTE' | 'GROUP_BY_TIME_INTERVAL_SECOND'

Interval unit by which the objects should be grouped.

list_parameters.group_by_time.group_sizeinteger

Size of the time interval to group the objects by, for example, to group objects by 2-week intervals, set interval to GROUP_BY_TIME_INTERVAL_WEEK and group_size to 2.

list_parameters.group_by_time.start_timestring date-time

Beginning of the time period to group objects. Defaults to the beginning of time.

list_parameters.group_by_time.end_timestring date-time

End of the time period to group objects. Defaults to the current time.

list_parameters.group_by_time.modestring

The mode determines how the matching objects are counted in the produced time-series. Values allowed are: count (default) : is the number of items matching in every interval. sum: is the total number of items matching since the beginning of the aggregation time.

list_parameters.group_by_time.aggregation_value_fieldstring

The aggregation_field is a field on the matched objects that we want to perform some operation in each interval (example : min, max, avg)

list_parameters.group_by_time.aggregation_operatorstring

The aggreation_operator is the operator that we should use for the aggregation. Allowed values are: min, max, sum, avg

list_parameters.disable_paginationboolean

If true, the results will not be paginated and only the first page will be returned. The order of the results is not guaranteed.

Response

A successful response.