---
title: "Update a project"
method: PUT
path: "/api/preview/projects/{id}"
tags: ["project"]
---

# Update a project

`PUT /api/preview/projects/{id}`

## Path parameters

- `id` string, required — UUID v4 string

## Request body

- object
  - `color` string, nullable — Display color hex; send `null` to clear.
  - `description` string — Updated description.
  - `name` string — New project name.
  - `visibility` 'self' | 'org_view' | 'org_edit' — Sharing scope. Promoting from `self` requires the project to already live in an org workspace.

## Response `200`

Successful response

- object
  - `capsule_count` integer
  - `capsules` object[]
  - `color` string, nullable
  - `content_bytes` integer, nullable
  - `created_at` string
  - `defaulted_type_count` integer
  - `description` string, nullable
  - `id` string, required — UUID v4 string
  - `name` string
  - `organization_id` string, nullable
  - `slug` string
  - `types` object[]
  - `updated_at` string
  - `user_id` string
  - `visibility` string
  - `workspace_id` string, nullable

---

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