---
title: "Update project details"
method: PATCH
path: "/api/v1/deployments/{deploymentSlug}/projects/{projectName}"
tags: ["ProjectsService"]
---

# Update project details

`PATCH /api/v1/deployments/{deploymentSlug}/projects/{projectName}`

Update attributes for the project using the value passed in to the request body.

## 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

- ProtosOpenapiV1UpdateProjectRequest
  - `deploymentSlug` string — Slug of the deployment name. Can be found at `/deployments`, or in your Settings in the web UI.
  - `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.
  - `primary_branch` string — The full name of the branch you would like to set as primary. Use "None" if default_branch is known and you wish to set primary to always be the default branch.
  - `projectName` string — Name of the project, typically the repository formatted as a path.
  - `tags` string — Tags associated to this project.

## Response `200`

OK

- ProtosOpenapiV1UpdateProjectResponse — Successfully updated details for the 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)