---
title: "Update project details"
method: PATCH
path: "/organizations/{organizationID}/projects/{projectID}"
tags: ["Projects"]
---

# Update project details

`PATCH /organizations/{organizationID}/projects/{projectID}`

Updates the details of a specific project by its ID, such as changing its name.

## Path parameters

- `organizationID` string, required
- `projectID` string, required

## Request body

- object
  - `name` string — New name for the project
  - `configuration` UpdateProjectConfiguration — Partial configuration update for a project
    - `scaleToZero` ProjectScaleToZeroConfiguration — Whether the project branches are configured to scale down to zero when not in use
      - `baseBranches` ScaleToZeroConfiguration, required — Configuration for scaling branches to zero when not in use
        - `enabled` boolean, required — Whether scale to zero is enabled
        - `inactivityPeriodMinutes` integer, required — Duration in minutes after which branches will be hibernated if not accessed
      - `childBranches` ScaleToZeroConfiguration, required — Configuration for scaling branches to zero when not in use
        - `enabled` boolean, required — Whether scale to zero is enabled
        - `inactivityPeriodMinutes` integer, required — Duration in minutes after which branches will be hibernated if not accessed
    - `ipFiltering` IPFilteringConfiguration — Configuration for IP filtering on project branches
      - `enabled` boolean, required — Whether IP filtering is enabled
      - `cidr` CidrEntry[], required
        - `cidr` string, required — IP address or CIDR block (e.g., "192.168.0.0/24")
        - `description` string — Optional label for the CIDR entry

## Response `200`

Project successfully updated

- Project — Details of a project including its ID, name, and creation/update timestamps
  - `id` string, required — Unique identifier for the project
  - `name` string, required — Human-readable name of the project
  - `createdAt` string, date-time, required — Timestamp when the project was created
  - `updatedAt` string, date-time, required — Timestamp when the project was last updated
  - `configuration` ProjectConfiguration, required — Configuration details for a project, including its scale to zero settings
    - `scaleToZero` ProjectScaleToZeroConfiguration, required — Whether the project branches are configured to scale down to zero when not in use
      - `baseBranches` ScaleToZeroConfiguration, required — Configuration for scaling branches to zero when not in use
        - `enabled` boolean, required — Whether scale to zero is enabled
        - `inactivityPeriodMinutes` integer, required — Duration in minutes after which branches will be hibernated if not accessed
      - `childBranches` ScaleToZeroConfiguration, required — Configuration for scaling branches to zero when not in use
        - `enabled` boolean, required — Whether scale to zero is enabled
        - `inactivityPeriodMinutes` integer, required — Duration in minutes after which branches will be hibernated if not accessed
    - `ipFiltering` IPFilteringConfiguration — Configuration for IP filtering on project branches
      - `enabled` boolean, required — Whether IP filtering is enabled
      - `cidr` CidrEntry[], required
        - `cidr` string, required — IP address or CIDR block (e.g., "192.168.0.0/24")
        - `description` string — Optional label for the CIDR entry

## Other responses

- `400` — Generic error response for most error conditions
- `401` — Error response when authentication or authorization fails
- `404` — Generic error response for most error conditions
- `5XX` — Unexpected Error
- `default` — Unexpected Error

## Changes

> 39 revisions in range; 2 could not be searched.

- **2026-07-16** `6245054fcd90` — 1 breaking, 2 warning
  - the `configuration/ipFiltering/cidr/items/cidr` request property's minLength was increased from `0` to `1`
  - the `configuration/ipFiltering/cidr/items/cidr` request property's maxLength was set to `64`
  - the `configuration/ipFiltering/cidr/items/description` request property's maxLength was set to `100`
- **2026-04-15** `a2cc5189d200` — 3 breaking, 1 info
  - the `configuration/ipFiltering/cidr/items/cidr` response property's maxLength was unset from `64` for the response status `200`
  - the `configuration/ipFiltering/cidr/items/description` response property's maxLength was unset from `100` for the response status `200`
  - the `configuration/ipFiltering/cidr/items/cidr` response property's minLength was decreased from `1` to `0` for the response status `200`
  - the `configuration/ipFiltering/cidr/items/cidr` request property's minLength was decreased from `1` to `0`

[Change history](https://skmtc.dev/xataio/apis/xata-api/changes/organizations/:organizationID/projects/:projectID/patch.md)

---

[API](https://skmtc.dev/xataio/apis/xata-api.md) · [All operations](https://skmtc.dev/xataio/apis/xata-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/xataio/xata-api/revisions/f3e5b60db9e1/schema)