---
title: "PUT /api/v1/projects/{project_id}"
method: PUT
path: "/api/v1/projects/{project_id}"
tags: ["project"]
---

# PUT /api/v1/projects/{project_id}

`PUT /api/v1/projects/{project_id}`

## Request

- The document declares no server URL.
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/kubermatic/apis/kubermatic-kubernetes-platform-api/docs/api/v1/projects/:project_id/put.ts> (a function with typed inputs; its response is checked against the schema)

Updates the given project

## Path parameters

- `project_id` string, required

## Request body

- Project: Project is a top-level container for a set of resources
  - `annotations` object: Annotations that can be added to the resource
  - `clustersNumber` integer
  - `creationTimestamp` string, date-time: CreationTimestamp is a timestamp representing the server time when this object was created.
  - `deletionTimestamp` string, date-time: DeletionTimestamp is a timestamp representing the server time when this object was deleted.
  - `id` string: ID unique value that identifies the resource generated by the server. Read-Only.
  - `labels` object
  - `name` string: Name represents human readable name for the resource
  - `owners` User[]: Owners an optional owners list for the given project
    - `annotations` object: Annotations that can be added to the resource
    - `creationTimestamp` string, date-time: CreationTimestamp is a timestamp representing the server time when this object was created.
    - `deletionTimestamp` string, date-time: DeletionTimestamp is a timestamp representing the server time when this object was deleted.
    - `email` string: Email an email address of the user
    - `id` string: ID unique value that identifies the resource generated by the server. Read-Only.
    - `isAdmin` boolean: IsAdmin indicates admin role
    - `name` string: Name represents human readable name for the resource
    - `projects` ProjectGroup[]: Projects holds the list of project the user belongs to along with the group names
      - `group` string
      - `id` string
    - `userSettings` UserSettings: UserSettings represent an user settings
      - `collapseSidenav` boolean
      - `displayAllProjectsForAdmin` boolean
      - `itemsPerPage` integer
      - `lastSeenChangelogVersion` string
      - `selectProjectTableView` boolean
      - `selectedProjectId` string
      - `selectedTheme` string
  - `status` string

## Response `200`

Project

- Project: Project is a top-level container for a set of resources
  - `annotations` object: Annotations that can be added to the resource
  - `clustersNumber` integer
  - `creationTimestamp` string, date-time: CreationTimestamp is a timestamp representing the server time when this object was created.
  - `deletionTimestamp` string, date-time: DeletionTimestamp is a timestamp representing the server time when this object was deleted.
  - `id` string: ID unique value that identifies the resource generated by the server. Read-Only.
  - `labels` object
  - `name` string: Name represents human readable name for the resource
  - `owners` User[]: Owners an optional owners list for the given project
    - `annotations` object: Annotations that can be added to the resource
    - `creationTimestamp` string, date-time: CreationTimestamp is a timestamp representing the server time when this object was created.
    - `deletionTimestamp` string, date-time: DeletionTimestamp is a timestamp representing the server time when this object was deleted.
    - `email` string: Email an email address of the user
    - `id` string: ID unique value that identifies the resource generated by the server. Read-Only.
    - `isAdmin` boolean: IsAdmin indicates admin role
    - `name` string: Name represents human readable name for the resource
    - `projects` ProjectGroup[]: Projects holds the list of project the user belongs to along with the group names
      - `group` string
      - `id` string
    - `userSettings` UserSettings: UserSettings represent an user settings
      - `collapseSidenav` boolean
      - `displayAllProjectsForAdmin` boolean
      - `itemsPerPage` integer
      - `lastSeenChangelogVersion` string
      - `selectProjectTableView` boolean
      - `selectedProjectId` string
      - `selectedTheme` string
  - `status` string

## Other responses

- `400`: EmptyResponse is a empty response
- `404`: EmptyResponse is a empty response
- `500`: EmptyResponse is a empty response
- `501`: EmptyResponse is a empty response
- `default`: errorResponse

---

[API](https://skmtc.dev/kubermatic/apis/kubermatic-kubernetes-platform-api.md) - [All operations](https://skmtc.dev/kubermatic/apis/kubermatic-kubernetes-platform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/kubermatic/apis/kubermatic-kubernetes-platform-api/revisions/815b9bf19db5?raw)