# Add or Update Guest Room

<mark style="color:green;">`POST`</mark> `[PlatformAddress]/api/1.0/venue?action=addOrUpdateGuestRoom`

#### Request Body

| Name              | Type    | Description                                               |
| ----------------- | ------- | --------------------------------------------------------- |
| id                | integer | The unique id of the guest room                           |
| venueId           | integer | The unique id of the venue to which the rate plan belongs |
| name              | string  | The name of the venue room                                |
| code              | string  | The unique code assigned to the room                      |
| categoryIds       | array   | An array of category ids to which the room belongs.       |
| capacity          | integer | The total number of this room type at the venue.          |
| description       | string  | A html formatted description of the room.                 |
| numStandardAdults | integer | The number of standard adults allowed in the room.        |
| numExtraAdults    | integer | The number of standard adults allowed in the room.        |
| extraAdultCost    | number  | The price of adding an extra adult to the room.           |
| canSmoke          | bool    | Whether or not smoking is allowed in the room.            |
| active            | bool    | Whether or not venue room is active on marketplace.       |
| marketplaceName   | bool    | Whether or not venue room is active on marketplace.       |

{% tabs %}
{% tab title="200 " %}

```
{
  "success": true,
  "id": 10
}
```

{% endtab %}
{% endtabs %}

### Example Request

#### Add Guest Room

```javascript
{
  "venueId": "1",
  "name": "Room 3.3",
  "extraAdultCost": "15",
  "categoryIds": [
    1,2
  ],
  "capacity": 10,
  "description": "this is testing",
  "numStandardAdults": 5,
  "numExtraAdults": 0,
  "canSmoke": "0",
  "active": "0"
}
```

#### Update Guest Room

```javascript
{
  "venueId": "1",
  "name": "Room 3.4",
  "id": 54
}
```

### Returns

| Property | Description                                              |
| -------- | -------------------------------------------------------- |
| success  | Whether or not the Space Blockout was added to the venue |
| id       | The unique id of the Space Blockout                      |

### Throws

| Code                 | Description                       |
| -------------------- | --------------------------------- |
| Specific Code: 24312 | The room does not exist           |
| Specific Code: 24313 | An error has occurred             |
| Specific Code: 24314 | The request contains invalid data |
| Specific Code: 24315 | An unknown error has occurred     |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.ivvy.com/venues/venuedata/add-or-update-guest-room.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.