Update a namespace

PUT

/api/v4/namespaces/{id}

• GitLab REST API

Deprecated in 17.8

Authorizations

• http
• oauth2

Parameters

Path Parameters

id

required

One of:

string

string

integer

integer

The ID or URL-encoded path of the namespace

Request Body

Media type application/json

object

shared_runners_minutes_limit

Compute minutes quota for this namespace

integer

nullable

extra_shared_runners_minutes_limit

Extra compute minutes for this namespace

integer

nullable

additional_purchased_storage_size

Additional storage size for this namespace

integer

nullable

additional_purchased_storage_ends_on

End of subscription of the additional purchased storage

string format: date

nullable

gitlab_subscription_attributes

Object that contains information on the GitLab subscription

object

start_date

Start date of subscription

string format: date

nullable

seats

Number of seats in subscription

integer

nullable

max_seats_used

Highest number of active users in the last month

integer

nullable

plan_code

Subscription tier code

string

nullable

end_date

End date of subscription

string format: date

nullable

auto_renew

Whether subscription will auto renew on end date

boolean

nullable

trial

Whether the subscription is a trial

boolean

nullable

trial_ends_on

End date of trial

string format: date

nullable

trial_starts_on

Start date of trial

string format: date

nullable

trial_extension_type

Whether subscription is an extended or reactivated trial

integer

nullable

Example ^generated

{
  "shared_runners_minutes_limit": 1,
  "extra_shared_runners_minutes_limit": 1,
  "additional_purchased_storage_size": 1,
  "additional_purchased_storage_ends_on": "2026-04-15",
  "gitlab_subscription_attributes": {
    "start_date": "2026-04-15",
    "seats": 1,
    "max_seats_used": 1,
    "plan_code": "example",
    "end_date": "2026-04-15",
    "auto_renew": true,
    "trial": true,
    "trial_ends_on": "2026-04-15",
    "trial_starts_on": "2026-04-15",
    "trial_extension_type": 1
  }
}

Responses

200

OK

Media type application/json

object

id

integer format: int64

name

string

path

string

kind

string

full_path

string

parent_id

integer format: int64

avatar_url

string

web_url

string

members_count_with_descendants

integer

root_repository_size

integer

projects_count

integer

shared_runners_minutes_limit

integer

extra_shared_runners_minutes_limit

integer

additional_purchased_storage_size

integer

additional_purchased_storage_ends_on

string format: date

billable_members_count

integer

seats_in_use

integer

max_seats_used

integer

max_seats_used_changed_at

string format: date

end_date

string format: date

plan

string

trial_ends_on

string format: date

trial

boolean

Example

{
  "id": 2,
  "name": "project",
  "path": "my_project",
  "kind": "project",
  "full_path": "group/my_project",
  "parent_id": 1,
  "avatar_url": "https://example.com/avatar/12345",
  "web_url": "https://example.com/group/my_project",
  "members_count_with_descendants": 5,
  "root_repository_size": 123,
  "projects_count": 123,
  "shared_runners_minutes_limit": 133,
  "extra_shared_runners_minutes_limit": 133,
  "additional_purchased_storage_size": 1000,
  "additional_purchased_storage_ends_on": "2022-06-18",
  "billable_members_count": 2,
  "seats_in_use": 5,
  "max_seats_used": 100,
  "max_seats_used_changed_at": "2022-06-18",
  "end_date": "2022-06-18",
  "plan": "default",
  "trial_ends_on": "2022-06-18"
}

400

Bad Request

404

Not Found