---
title: "Update a namespace"
method: PUT
path: "/api/v4/namespaces/{id}"
tags: ["namespaces"]
---

# Update a namespace

`PUT /api/v4/namespaces/{id}`

## Request

- Base URL: `https://gitlab.com`
- URL: `https://gitlab.com/api/v4/namespaces/{id}`
- Auth: none declared

Deprecated in 17.8

## Path parameters

- `id` integer, required

## Request body

- PutApiV4NamespacesId: Update a namespace
  - `shared_runners_minutes_limit` integer: Compute minutes quota for this namespace
  - `extra_shared_runners_minutes_limit` integer: Extra compute minutes for this namespace
  - `additional_purchased_storage_size` integer: Additional storage size for this namespace
  - `additional_purchased_storage_ends_on` string, date: End of subscription of the additional purchased storage
  - `gitlab_subscription_attributes` object: Object that contains information on the GitLab subscription
    - `start_date` string, date: Start date of subscription
    - `seats` integer: Number of seats in subscription
    - `max_seats_used` integer: Highest number of active users in the last month
    - `plan_code` string: Subscription tier code
    - `end_date` string, date: End date of subscription
    - `auto_renew` boolean: Whether subscription will auto renew on end date
    - `trial` boolean: Whether the subscription is a trial
    - `trial_ends_on` string, date: End date of trial
    - `trial_starts_on` string, date: Start date of trial
    - `trial_extension_type` integer: Whether subscription is an extended or reactivated trial

## Response `200`

Update a namespace

- APIEntitiesNamespace: API_Entities_Namespace model
  - `id` integer, required
  - `name` string, required
  - `path` string, required
  - `kind` string, required
  - `full_path` string, required
  - `parent_id` integer, required
  - `avatar_url` string, required
  - `web_url` string, required
  - `members_count_with_descendants` integer
  - `root_repository_size` integer
  - `projects_count` integer
  - `shared_runners_minutes_limit` integer
  - `ci_minutes_usage` APIEntitiesCiMinutesUsage
    - `total_minutes_used` integer, required
    - `monthly_minutes_used` integer, required
    - `purchased_minutes_used` integer, required
  - `extra_shared_runners_minutes_limit` integer
  - `additional_purchased_storage_size` integer
  - `additional_purchased_storage_ends_on` string, date
  - `billable_members_count` integer, required
  - `seats_in_use` integer
  - `max_seats_used` integer
  - `max_seats_used_changed_at` string, date
  - `end_date` string, date
  - `plan` string
  - `trial_ends_on` string, date
  - `trial` boolean

---

[API](https://skmtc.dev/gitlab/apis/gitlab-api.md) - [All operations](https://skmtc.dev/gitlab/apis/gitlab-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gitlab/apis/gitlab-api/revisions/b234947ef3f2?raw)