# set_parcel_info

Updates parcel details (deprecated, see parcel_info_update)

## Variables

The following table shows input values (you send them with the API call) and returned output values.

### Input basic parameters

| Variable | Required | Description |
|----------|----------|-------------|
| action   | yes      | = set_parcel_info |
| apikey   | yes      | Your personal [developer's API key](/doc/developers-api-key-tw8bQj4LSJ). |
| botname  | yes      | Your bot's SL login. |
| secret   | yes      | [Bot access code](https://www.mysmartbots.com/docs/Bot_access_code) of your bot. |
| dataType | optional | Set to "json" to get JSON reply instead of URL-encoded string |
| custom   | optional | The custom data (string) to be passed back to caller script. This value will be returned back to the caller in HTTP response. |

### Input

| Variable | Required | Description |
|----------|----------|-------------|
| x        | optional | the X coordinate of the parcel (default - bot position) |
| y        | optional | the Y coordinate of the parcel (default - bot position) |
| entry    | yes      | the parcel entry to update (see the list below) |
| value    | yes      | the value to set |

### Output

(to be received in `http_response` LSL event, see [docs](/doc/doing-http-api-calls-c6FSEMF7bP) for details)

| Variable | Description |
|----------|-------------|
| result   | OK - command completed successfully<br>FAIL - command failed |
| resulttext | Detailed reason for the failure. |
| custom   | The value from input "custom" parameter. See above. |

## Available parcel entries

It is possible to update the following parcel entries. Set `entry` to:

* `name` – set the name of parcel
  * `value` parameter: the new parcel name
* `description` – set the parcel description
  * `value` parameter: the new parcel description
* `music_url` – set the parcel music URL
  * `value` parameter: the new music URL
* `for_sale` – make the parcel available for sale
  * `value` parameter format: `on|off price`
    * `on` – set parcel for sale
    * `off` – don't sell parcel
    * `price` – the parcel price (required but ignored for "don't sell")

## Permissions

Your bot has to own the parcel, or have some of the permissions:

* Parcel identity > "Change parcel name, description, and 'Moderate Content' setting"
* Parcel settings > "Change music & media settings"
* Parcel Management > "Set land for sale info"

## Return values

The command returns:

```
result=OK
```

if parcel update succeed.