> ## Documentation Index > Fetch the complete documentation index at: https://semgrep-ee9d73d8-api-changelog-from-openapi.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Changelog > Changes to the Semgrep API v2, generated from its OpenAPI specification. Changes to the [Semgrep API v2](/api-reference/v2/Introduction), detected by comparing successive versions of its OpenAPI specification. Breaking changes are labeled; documentation-only edits are not listed. **Subscribe to this changelog:** add [`https://docs.semgrep.dev/api-reference/v2/Changelog/rss.xml`](https://docs.semgrep.dev/api-reference/v2/Changelog/rss.xml) to any feed reader, or run `/feed subscribe https://docs.semgrep.dev/api-reference/v2/Changelog/rss.xml` in Slack to post new entries to a channel. Most readers also accept this page's own URL and find the feed automatically. **Breaking changes**
| Change | Description | Endpoint | | -------------------------------------------- | ------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Added | added the new required `header` request parameter `if-match` | PUT /api/policies/v2/deployments/\{deploymentId}/remediation-policies |
**Changes**
| Change | Description | Endpoint | | -------------------------------------------- | -------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Added | added the optional property `gitSha` to the response with the `200` status | GET /api/health-check | | Added | endpoint added | GET /api/workflows/v1/deployments/\{deploymentId}/jobs/id/\{jobId}/findings | | Added | endpoint added | GET /api/workflows/v1/deployments/\{deploymentId}/jobs/id/\{jobId}/overview | | Added | endpoint added | POST /api/workflows/v1/deployments/\{deploymentId}/jobs/list | | Added | endpoint added | GET /api/workflows/v1/deployments/\{deploymentId}/registry | | Added | endpoint added | POST /api/workflows/v1/deployments/\{deploymentId}/trigger |
**Changes**
| Change | Description | Endpoint | | -------------------------------------------- | ------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Added | added the optional property `byProject.additionalProperties.projectId` to the response with the `200` status | POST /api/reporting/\{deploymentId}/reports/by-project/by-product
POST /api/reporting/\{deploymentId}/reports/by-project/by-severity |
**Changes**
| Change | Description | Endpoint | | -------------------------------------------- | ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Added | added the new optional request property `filters.latestScanStatus` | PATCH /api/agent/deployments/\{deploymentId}/repos/filtered
POST /api/agent/deployments/\{deploymentId}/repos/\_provision
POST /api/agent/deployments/\{deploymentId}/repos/\_secret
and 1 more |
**Potentially breaking changes**
| Change | Description | Endpoint | | -------------------------------------------- | -------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Removed | removed the optional property `products.sast.autofix_pr_enabled` from the response with the `200` status | GET /api/agent/deployments/\{deploymentId}/products
PUT /api/agent/deployments/\{deploymentId}/products | | Removed | removed the request property `sast.autofix_pr_enabled` | PUT /api/agent/deployments/\{deploymentId}/products |
**Changes**
| Change | Description | Endpoint | | -------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Added | added the new `TRIGGER_SOURCE_PATCH_READY` enum value to the `triggerSource` request and response property | GET /api/notifications/deployments/\{deploymentId}/automations
GET /api/v2/deployments/\{deploymentId}/automations
POST /api/notifications/deployments/\{deploymentId}/automations
and 1 more | | Added | added the new enum value `TOKEN_ROLE_READ_ONLY` to the `query` request parameter `roleFilter` | DELETE /api/tokens/v1/deployments/\{deploymentId}/tokens |
**Changes**
| Change | Description | Endpoint | | -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Added | added the new optional request property `filter.hasInFlightAutofixPr` | PATCH /api/agent/deployments/\{deploymentId}/findings/v2
POST /api/agent/deployments/\{deploymentId}/issue\_counts
POST /api/agent/deployments/\{deploymentId}/issue\_filters
and 5 more | | Added | added the optional property `packageManagerConfigsWithCredentials[].config.registryType` to the response with the `200` status | GET /api/agent/deployments/\{deploymentId}/packagemanagerauthconfigs | | Added | added the new optional request property `packageManagerConfigForInsert.config.registryType` | PATCH /api/agent/deployments/\{deploymentId}/packagemanagerauthconfigs/\{packageManagerConfigId}
POST /api/agent/deployments/\{deploymentId}/packagemanagerauthconfigs | | Added | added the optional property `packageManagerConfig.registryType` to the response with the `200` status | PATCH /api/agent/deployments/\{deploymentId}/packagemanagerauthconfigs/\{packageManagerConfigId}
POST /api/agent/deployments/\{deploymentId}/packagemanagerauthconfigs | | Added | endpoint added | POST /api/issues/\{deploymentId}/counts | | Added | endpoint added | GET /api/issues/\{deploymentId}/issue/\{issueId} | | Added | endpoint added | POST /api/issues/\{deploymentId}/issue/\{issueId} | | Added | endpoint added | GET /api/issues/\{deploymentId}/issue/\{issueId}/activity | | Added | endpoint added | POST /api/issues/\{deploymentId}/search | | Added | added the new optional request property `issueFilters.hasInFlightAutofixPr` | POST /api/notifications/deployments/\{deploymentId}/ticketing/v2/\{ticketingInstanceId}/create\_tickets | | Added | added the optional property `projects[].scmType` to the response with the `200` status | POST /api/v2/deployments/\{deploymentId}/projects/list | | Added | added the optional property `project.scmType` to the response with the `200` status | DELETE /api/v2/deployments/\{deploymentId}/projects/\{projectId}
GET /api/v2/deployments/\{deploymentId}/projects/\{projectId} |
**Potentially breaking changes**
| Change | Description | Endpoint | | -------------------------------------------- | ---------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Removed | removed the optional property `instances[].transitionStates` from the response with the `200` status | GET /api/notifications/deployments/\{deploymentId}/ticketing/v2 |
**Changes**
| Change | Description | Endpoint | | -------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Added | added the optional property `errorDetail` to the response with the `200` status | POST /api/agent/deployments/\{deploymentId}/actions/\{notificationRuleId}/test
POST /api/notification\_webhooks/deployments/\{deploymentId}/webhooks/\{webhookId}/test | | Added | added the new `FIX_JOB_ERROR_TYPE_AI_PROVIDER_NOT_ALLOWED`, `FIX_JOB_ERROR_TYPE_ARCHIVED_REPOSITORY`, `FIX_JOB_ERROR_TYPE_AUTOFIX_DISABLED`, `FIX_JOB_ERROR_TYPE_GROUPING_DISABLED`, `FIX_JOB_ERROR_TYPE_INVALID_GROUP`, `FIX_JOB_ERROR_TYPE_NON_PRIMARY_BRANCH_DISABLED`, `FIX_JOB_ERROR_TYPE_UNSUPPORTED_ISSUE_TYPE` enum values to the `errors[].errorType` response property for the response status `200` | POST /api/agent/deployments/\{deploymentId}/issues/\{issueId}/fix\_jobs | | Added | added the optional property `products.ai.mdr_enabled` to the response with the `200` status | GET /api/agent/deployments/\{deploymentId}/products
PUT /api/agent/deployments/\{deploymentId}/products | | Added | added the optional property `automations[].actions[].id` to the response with the `200` status | GET /api/notifications/deployments/\{deploymentId}/automations
GET /api/v2/deployments/\{deploymentId}/automations | | Added | added the new optional request property `automation.actions[].id` | POST /api/notifications/deployments/\{deploymentId}/automations
PUT /api/notifications/deployments/\{deploymentId}/automations/\{automationId} | | Added | added the optional property `automation.actions[].id` to the response with the `200` status | POST /api/notifications/deployments/\{deploymentId}/automations
PUT /api/notifications/deployments/\{deploymentId}/automations/\{automationId} | | Added | added the optional property `instances[].fixedTransitionState` to the response with the `200` status | GET /api/notifications/deployments/\{deploymentId}/ticketing/v2 |
**Changes**
| Change | Description | Endpoint | | -------------------------------------------- | ------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Added | added the new `TOUR_ID_WORKFLOWS_ACTIVATION` enum value to the `id` request and response property | GET /api/auth/users/current/settings
PATCH /api/auth/users/current/settings | | Added | added the new `WorkflowsActivationBanner` enum value to the request property `eventSource` | PATCH /api/auth/users/current/settings |
**Changes**
| Change | Description | Endpoint | | -------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Added | added the new `CONDITION_TYPE_BREAKING_CHANGE`, `CONDITION_TYPE_FULL_SCAN` enum values to the `type` request and response property | GET /api/notifications/deployments/\{deploymentId}/automations
GET /api/v2/deployments/\{deploymentId}/automations
POST /api/notifications/deployments/\{deploymentId}/automations
and 1 more | | Added | added the new `TRIGGER_SOURCE_UPGRADE_GUIDANCE` enum value to the `triggerSource` request and response property | GET /api/notifications/deployments/\{deploymentId}/automations
GET /api/v2/deployments/\{deploymentId}/automations
POST /api/notifications/deployments/\{deploymentId}/automations
and 1 more |
**Potentially breaking changes**
| Change | Description | Endpoint | | -------------------------------------------------- | ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Deprecated | endpoint deprecated | GET /api/policies/v1/deployments/\{deploymentId} | | Deprecated | endpoint deprecated | GET /api/policies/v1/deployments/\{deploymentId}/\{policyId}/rules | | Deprecated | endpoint deprecated | PUT /api/policies/v1/deployments/\{deploymentId}/\{policyId}/rules/\{rulePath} |
**Changes**
| Change | Description | Endpoint | | -------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Added | added the new optional request property `includeFirstDetectedAt` | POST /api/agent/deployments/\{deploymentId}/issues
POST /api/agent/deployments/\{deploymentId}/issues/export | | Added | added the optional property `issues[].issue.exceptionRequest.requesterName` to the response with the `200` status | POST /api/agent/deployments/\{deploymentId}/issues | | Added | added the optional property `issues[].issue.exceptionRequest.reviewerName` to the response with the `200` status | POST /api/agent/deployments/\{deploymentId}/issues | | Added | added the optional property `issues[].issue.firstDetectedAt` to the response with the `200` status | POST /api/agent/deployments/\{deploymentId}/issues | | Added | added the optional property `exceptionRequest.requesterName` to the response with the `200` status | GET /api/agent/deployments/\{deploymentId}/issues/v2/\{issueId} | | Added | added the optional property `exceptionRequest.reviewerName` to the response with the `200` status | GET /api/agent/deployments/\{deploymentId}/issues/v2/\{issueId} | | Added | added the optional property `firstDetectedAt` to the response with the `200` status | GET /api/agent/deployments/\{deploymentId}/issues/v2/\{issueId} | | Added | added the optional property `users[].scimManaged` to the response with the `200` status | GET /api/agent/deployments/\{deploymentId}/users
POST /api/agent/deployments/\{deploymentId}/users/list | | Added | added the new `ACTION_TYPE_OPEN_AUTOFIX_PR`, `ACTION_TYPE_TRIGGER_WORKFLOW` enum values to the `type` request and response property | GET /api/notifications/deployments/\{deploymentId}/automations
GET /api/v2/deployments/\{deploymentId}/automations
POST /api/notifications/deployments/\{deploymentId}/automations
and 1 more | | Added | added the new `CONDITION_TYPE_CWE`, `CONDITION_TYPE_OWASP` enum values to the `type` request and response property | GET /api/notifications/deployments/\{deploymentId}/automations
GET /api/v2/deployments/\{deploymentId}/automations
POST /api/notifications/deployments/\{deploymentId}/automations
and 1 more | | Added | added the new optional request property `issueTypes` | POST /api/notifications/deployments/\{deploymentId}/ticketing/v2/\{ticketingInstanceId}/create\_tickets | | Added | added the optional property `findings[].exceptionRequest.requesterName` to the response with the `200` status | POST /api/reporting/\{deploymentId}/findings | | Added | added the optional property `findings[].exceptionRequest.reviewerName` to the response with the `200` status | POST /api/reporting/\{deploymentId}/findings | | Added | added the optional property `findings[].firstDetectedAt` to the response with the `200` status | POST /api/reporting/\{deploymentId}/findings | | Added | added the new optional request property `filters.timeBucketSize` | POST /api/reporting/\{deploymentId}/reports/malware-firewall/blocked-mal-deps/by-advisory
POST /api/reporting/\{deploymentId}/reports/malware-firewall/blocked-mal-deps/by-dep-version-and-ecosystem
POST /api/reporting/\{deploymentId}/reports/malware-firewall/blocked-mal-deps/by-ecosystem | | Added | endpoint added | POST /api/reporting/\{deploymentId}/reports/malware-firewall/scan-activity | | Added | endpoint added | POST /api/reporting/\{deploymentId}/reports/malware-firewall/summary | | Added | added the new optional `query` request parameter `dependencyFilter.includeArchived` | GET /api/sca/deployments/\{deploymentId}/dependencies | | Added | added the new optional request property `dependencyFilter.includeArchived` | POST /api/sca/deployments/\{deploymentId}/dependencies
POST /api/sca/deployments/\{deploymentId}/repositories
POST /api/sca/deployments/\{deploymentId}/\{repositoryId}/lockfiles |