Update the subscription for the namespace

Deprecated

PUT

/api/v4/namespaces/{id}/gitlab_subscription

• GitLab REST API

Deprecated in GitLab 17.7

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

start_date

Start date of subscription

string format: date

nullable

end_date

End date of subscription

string format: date

nullable

plan_code

Subscription tier code

string

nullable

seats

Number of seats in subscription

integer

nullable

max_seats_used

Highest number of active users in the last month

integer

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 the trial was extended or reactivated

integer

nullable

Example ^generated

{
  "start_date": "2026-04-15",
  "end_date": "2026-04-15",
  "plan_code": "example",
  "seats": 1,
  "max_seats_used": 1,
  "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

plan

object

usage

object

billing

object

Example ^generated

{
  "plan": {},
  "usage": {},
  "billing": {}
}

400

Bad Request

404

Not Found