---
title: "Bulk triage"
method: POST
path: "/api/v1/deployments/{deploymentSlug}/triage"
tags: ["TriageService"]
---

# Bulk triage

`POST /api/v1/deployments/{deploymentSlug}/triage`

Bulk triage your findings. You can select the findings to triage by passing in a list of finding IDs as issue_ids, or by passing in filter query parameters. You must specify the issue_type of the findings you want to bulk triage. One of new_triage_state or new_note is required. If specifying a new_triage_reason, you must also use new_triage_state=ignored. Some filters only apply for findings associated with a given product.

## Path parameters

- `deploymentSlug` string, required — Deployment slug. Can be found at /deployments, or in your Settings in the web UI.

## Request body

- ProtosOpenapiV1BulkTriageRequest
  - `autotriage_verdict` 'true_positive' | 'false_positive' — The autotriage verdict to filter by
  - `categories` string[] — List of categories to filter by
  - `component_tags` string[] — List of component tags to filter by
  - `confidence` 'low' | 'medium' | 'high' — List of confidence levels to filter by
  - `dependencies` string[] — Filter by dependency name. Only applies for sca findings.
  - `epss_probability` string[] — Filter by EPSS probability (likelihood of exploit). Only applies for sca findings.
  - `exposures` string[] — Filter by exposure (reachability type). Only applies for sca findings. Reachability is the ability of an attacker to access a vulnerability in a system.
  - `include_historical` boolean — Whether to include historical findings. Only applies for secrets findings. Defaults to true.
  - `issue_ids` integer[] — An array of issue IDs to act on. If this is not provided, an issue filter should be provided.
  - `issue_type` 'sast' | 'sca' | 'secrets', required — Type of findings to bulk triage.
  - `limit` integer — Max number of issues to triage. Must be an integer between 1 and 3000. Defaults to 3000. When selecting findings to triage, Semgrep will also triage findings with the same fingerprint on other branches. As a result, the list of triaged issue_ids returned in the response may be higher than the specified limit.
  - `new_note` string — The note to attach to the bulk triaged findings. Maximum 3000 characters.
  - `new_triage_reason` 'acceptable_risk' | 'false_positive' | 'no_time' | 'no_triage_reason' | 'duplicate' — The reason for triaging to a given triage state.
  - `new_triage_state` 'ignored' | 'reviewing' | 'fixing' | 'reopened' | 'provisionally_ignored' — The triage state you would like to bulk triage your findings to.
  - `policies` string[] — List of policy modes to filter by
  - `policy_mode` string[] — List of policy modes to filter by
  - `pro_only` boolean — Filter by whether a finding is only available with Semgrep Pro features.
  - `project_tags` string[] — List of project tags to filter by
  - `ref` string — Branch reference to filter by
  - `repos` string[] — List of repository names to filter by
  - `repository_visibility` string[] — Filter by repository visibility. Only applies for secrets findings.
  - `rules` string[] — List of rule names to filter by
  - `ruleset` string[] — List of Semgrep Registry rulesets to filter by
  - `secret_types` string[] — Filter by type of secret (typically provider-related). Only applies for secrets findings.
  - `severities` string[] — List of severities to filter by
  - `since` string — Epoch timestamp in seconds. Filters using the relevant_since field: the timestamp when this finding was detected by Semgrep (the first time, or when reintroduced).
  - `status` 'open' | 'fixed' | 'ignored' | 'reviewing' | 'fixing' | 'provisionally_ignored' — The status to filter by
  - `transitivities` string[] — Filter by transitivity of a dependency. Only applies for sca findings.
  - `triage_reasons` string[] — List of triage reasons to filter by
  - `validation_state` string[] — Filter by whether a secret could be validated. Only applies for secrets findings.

## Response `200`

OK

- ProtosOpenapiV1BulkTriageResponse
  - `num_triaged` integer, required — Number of items updated
  - `triaged_issues` integer[], required — List of triaged issue IDs

---

[API](https://skmtc.net/semgrep/apis/semgrep-web-app.md) · [All operations](https://skmtc.net/semgrep/apis/semgrep-web-app/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/semgrep/semgrep-web-app/revisions/6483eeecd582/schema)