# Add or Update Booking Session
`POST` `[PlatformAddress]/api/1.0/venue?action=addOrUpdateBookingSession`
Adds or updates the details of a venue booking session. NOTE: The venue must have access to add or update booking session in order to call this api action.
{% tabs %}
{% tab title="200 " %}
```javascript
{
"success": true,
"id": 8821,
"warnings": null
}
```
{% endtab %}
{% tab title="200 " %}
```javascript
{
"errorCode": 400,
"message": "The request contains invalid data",
"specificCode": 24337,
"additionalMessages": [
"costcenterId: *Value is required and can't be empty*"
]
}
```
{% endtab %}
{% tab title="200 " %}
```javascript
{
"errorCode": 500,
"message": "An error has occurred",
"specificCode": 24335,
"additionalMessages": []
}
```
{% endtab %}
{% endtabs %}
### Booking Session
| Property | Type | Required | Description |
| ---------------------- | ------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| id | integer | optional | The unique id of the booking session to update. A new booking session will be created if this parameter is not present. |
| spaceVenueId | integer | required | The id of the venue to which the booking session belongs. |
| bookingId | integer | required | The id of the booking to which the new booking session will be assigned. |
| contactId | integer | required | The id of the booking to which the new booking session will be assigned. |
| name | string | required | The booking session name. Required when adding a new booking session. |
| minAttendeesGuaranteed | integer | optional | The total attendees of the booking session. Required when adding new booking session. |
| agreedAttendees | integer | optional | The agreed attendees of the booking session. |
| expectedAttendees | integer | optional | The expected attendees of the booking session. |
| guaranteedAttendees | integer | optional | The guaranteed attendees of the booking session. |
| setAttendees | integer | optional | The set attendees of the booking session. |
| actualAttendees | integer | optional | The actual attendees of the booking session. |
| spaceId | integer | optional | The id of the space to which the booking session belongs. |
| spaceLayout | integer | optional | The id of the space layout to which the booking session belongs. |
| layoutType | integer | optional | The [type](/venues/venuedata/get-function-space-list.md#layout-types) of the space layout to which the booking session belongs. (This key will only consider when you don't pass spaceLayout key in request data) |
| customLayoutName | string | optional | The name of custom space layout. |
| startDate | date | required | Start date of the sesion. |
| startTime | string | optional | The start time of the booking session. Format is HH:mm:ss |
| endTime | string | optional | The end time of the booking session. Format is HH:mm:ss |
| setupTime | integer | optional | The setup time (in mins) of the booking session. |
| setdownTime | integer | optional | The setdown time (in mins) of the booking session |
| includeInPackage | boolean | optional | Whether or not the booking session is included in booking package. |
| bookingPackageId | integer | optional | The id of the booking package to which the booking session belongs. Required when includeInPackage is true |
| tariffId | integer | optional | The tariff id to which the booking session belongs. Required when includeInPackage is true |
| roomHireType | integer | optional | The room hire type to which the booking session belongs. Required when includeInPackage is true |
| costcenterId | integer | optional | The id of the cost center to which the booking session belongs. Required when adding new booking session |
| cost | double | optional | The price of the booking session. Required when includeInPackage is false |
| excludedTaxIds | array | optional | The array of tax Ids which are excluded to apply on the booking session. Required when includeInPackage is false |
| sessionTypeId | integer | optional | The session type id to which the session belogns |
| overridePax | bool | optional | Whether or not to over ride max pax of the space |
| isSignageVisible | bool | optional | isSignageVisible |
| signage | string | optional | Signage of the booking session |
### Example Request
```javascript
{
"venueId": 1,
"bookingId": 15722,
"spaceVenueId": 1,
"name": "test",
"contactId": 10,
"minAttendeesGuaranteed": 10,
"spaceId": 3,
"spaceLayout": 0,
"customLayoutName": "test",
"startDate": "2020-10-28",
"startTime": "10:00:00",
"endTime": "11:00:00",
"setupTime": "60",
"setdownTime": "60",
"includeInPackage": 0,
"bookingPackageId": 2018,
"tariffId": "1",
"roomHireType": "1",
"costcenterId": "4",
"cost": "400",
"excludedTaxIds": []
}
```
### Returns
| Property | Description |
| -------- | ---------------------------------------------------------- |
| success | Whether or not the session is added/updated to the booking |
| id | The unique id of the Booking Session |
### Throws
| Code | Description |
| -------------------- | --------------------------------- |
| Specific Code: 24360 | The booking does not exist |
| Specific Code: 24361 | The session does not exist |
| Specific Code: 24362 | An error has occurred |
| Specific Code: 24363 | The request contains invalid data |
| Specific Code: 24364 | The request contains invalid data |
---
# 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/getoraddbookingdata/add-or-update-booking-session.md?ask=
```
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.