---
title: "Update project details"
method: POST
path: "/v1/{org_name}/projects/{project}"
tags: ["Projects"]
---

# Update project details

`POST /v1/{org_name}/projects/{project}`

## Path parameters

- `org_name` string, required
- `project` string, required

## Request body

- object
  - `name` string, required
  - `catalog` string, nullable, required
  - `groups` string[], nullable, required — List of group slugs associated with the project
  - `branching_behavior` 'specified_branch' | 'latest_aligned_branch', required — Controls how the project's default branch is determined. `specified_branch` uses the branch set in `default_branch`. `latest_aligned_branch` automatically updates to the most recently aligned branch.
  - `default_branch` string, required
  - `external_identifier` string, nullable, required — An optional custom identifier that can be set that corresponds to something outside of Tidelift

## Response `200`

Successfully updated project details

## Other responses

- `401` — Unauthorized
- `403` — The user is not an admin of the organization or doesn't belong to the organization.
- `404` — Invalid catalog or groups sent

---

[API](https://skmtc.net/tidelift/apis/tidelift-external-api.md) · [All operations](https://skmtc.net/tidelift/apis/tidelift-external-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tidelift/tidelift-external-api/revisions/5f36bed372bb/schema)