---
title: "Update a project"
method: PUT
path: "/v1/org/project/{projectId}"
tags: ["Organization Project"]
---

# Update a project

`PUT /v1/org/project/{projectId}`

## Request

- Base URL: `https://api.roark.ai`
- URL: `https://api.roark.ai/v1/org/project/{projectId}`
- Auth: HTTP bearer

Update a project name, description, or category.

## Path parameters

- `projectId` string, required

## Request body

- UpdateOrgProjectInput
  - `name` string
  - `description` string, nullable
  - `category` 'HEALTHCARE' | 'FINANCIAL' | 'RETAIL' | 'HOSPITALITY' | 'AUTOMOTIVE' | 'GOVERNMENT' | 'EDUCATION' | 'REAL_ESTATE' | 'OTHER'

## Response `200`

The updated project

- object
  - `data` OrgProject, required
    - `id` string, required: Project id
    - `organizationId` string, required
    - `name` string, required
    - `slug` string, required: URL-safe slug, generated from the name at create time
    - `description` string, nullable, required
    - `category` 'HEALTHCARE' | 'FINANCIAL' | 'RETAIL' | 'HOSPITALITY' | 'AUTOMOTIVE' | 'GOVERNMENT' | 'EDUCATION' | 'REAL_ESTATE' | 'OTHER', nullable, required
    - `dataStorageRegion` 'US_EAST_1' | 'EU_WEST_1', required
    - `retentionDays` integer, nullable, required
    - `retentionMode` 'SOFT_DELETE' | 'HARD_DELETE', required
    - `configKey` string, nullable, required
    - `createdAt` string, required: ISO 8601 timestamp
    - `updatedAt` string, required: ISO 8601 timestamp

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `500`: Internal Server Error

## Changes

> 188 revisions in range; 1 not diffed.

- **2026-09-28** `f647fa40d8bb`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/roarkhq/apis/roark-analytics-api/changes/v1/org/project/:projectId/put.md)

---

[API](https://skmtc.dev/roarkhq/apis/roark-analytics-api.md) - [All operations](https://skmtc.dev/roarkhq/apis/roark-analytics-api/llms.txt) - [OpenAPI document](https://skmtc.dev/roarkhq/apis/roark-analytics-api/revisions/1a91a5c90e44?raw)