---
title: "Toggle Managed Scans for a project"
method: PATCH
path: "/api/v1/deployments/{deploymentSlug}/projects/{projectName}/managed-scan"
tags: ["ProjectsService"]
---

# Toggle Managed Scans for a project

`PATCH /api/v1/deployments/{deploymentSlug}/projects/{projectName}/managed-scan`

Enable or disable
[Semgrep Managed Scans](/docs/deployment/managed-scanning/overview)
for a project.

## Path parameters

- `deploymentSlug` string, required — Slug of the deployment name. Can be found at `/deployments`, or in your Settings in the web UI.
- `projectName` string, required — Name of the project, typically the repository formatted as a path.

## Request body

- ProtosOpenapiV1ToggleProjectManagedScanRequest
  - `deploymentSlug` string — Slug of the deployment name. Can be found at `/deployments`, or in your Settings in the web UI.
  - `diff_scan` ProtosOpenapiV1DiffScan
    - `enabled` boolean — When true, diff-aware scans are enabled for the project.
  - `full_scan` ProtosOpenapiV1FullScan
    - `enabled` boolean — When true, weekly full scans are enabled.
  - `projectName` string — Name of the project, typically the repository formatted as a path.

## Response `200`

OK

- ProtosOpenapiV1ToggleProjectManagedScanResponse — Successfully updated managed scan settings for project.
  - `project` ProtosOpenapiV1Project — A project in your organization that uses Semgrep.
    - `created_at` string — Time when this project was created.
    - `default_branch` string — The default branch in the SCM.
    - `id` number, required — Unique ID of this project.
    - `latest_scan_at` string — Time of latest scan, if there is one.
    - `managed_scan_config` ProtosOpenapiV1ManagedScanConfig — [Beta] Configuration of Semgrep Managed Scans for the project, if relevant.
      - `diff_scan` ProtosOpenapiV1DiffScan
        - `enabled` boolean — When true, diff-aware scans are enabled for the project.
      - `full_scan` ProtosOpenapiV1FullScan
        - `enabled` boolean — When true, weekly full scans are enabled.
    - `name` string, required — Name of the project.
    - `primary_branch` string — The primary branch of the project, if known.
    - `tags` string, required — Tags associated to this project.
    - `url` string — URL of the project, if there is one.

---

[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/versions/6483eeecd582/schema)