# Upgrade a license

From **GitHub v3 REST API**.

`POST /setup/api/upgrade`

This API upgrades your license and also triggers the configuration process.

**Note:** The request body for this operation must be submitted as `application/x-www-form-urlencoded` data. You can submit a parameter value as a string, or you can use a tool such as `curl` to submit a parameter value as the contents of a text file. For more information, see the [`curl` documentation](https://curl.se/docs/manpage.html#--data-urlencode).

## Request body

- Required: false
### `application/x-www-form-urlencoded`

- Type: `object`

```json
{"properties":{"license":{"description":"The content of your new _.ghl_ license file.","type":"string"}},"type":"object"}
```

## Responses

### `202`

Response

## Request examples

### cURL

```shell
curl --request POST \
  --url {protocol}://{hostname}/api/v3/setup/api/upgrade \
  --header 'content-type: application/x-www-form-urlencoded' \
  --data '{
  "license": "string"
}'
```