Update resource booking.v1.resource.update
Scope:
bookingWho can execute the method: any user
The method booking.v1.resource.update updates an existing resource.
Method Parameters
Required parameters are marked with *
|
Name |
Description |
|
id* |
Resource identifier. |
|
fields* |
An object containing field values to update the resource (detailed description) |
Parameter fields
|
Name |
Description |
|
name |
Resource name |
|
description |
Resource description |
|
typeId |
Resource type identifier. The list of available types can be found using the method booking.v1.resourceType.list |
|
isMain |
How to display the resource. Possible values:
|
|
isInfoNotificationOn |
Message to the client about the booking. Possible values:
|
|
templateTypeInfo |
Type of the booking message template. Possible values:
|
|
isConfirmationNotificationOn |
Automatic booking confirmation. Possible values:
|
|
templateTypeConfirmation |
Type of the confirmation message template. Possible values:
|
|
isReminderNotificationOn |
Reminder about the booking. Possible values:
|
|
templateTypeReminder |
Type of the reminder message template. Possible values: |
|
isFeedbackNotificationOn |
Request for feedback. Possible values:
|
|
templateTypeFeedback |
Type of the feedback request message template. Possible values:
|
|
isDelayedNotificationOn |
Reminder when the client is late. Possible values:
|
|
templateTypeDelayed |
Type of the delay message template. Possible values:
|
|
infoDelay |
Delay after which the client receives a booking message. Specified in seconds |
|
reminderDelay |
Time before the booking when the client receives a reminder. Specified in seconds |
|
delayedDelay |
Time after which to send a delay message to the client. Specified in seconds |
|
delayedCounterDelay |
Time after which to enable the counter in the calendar. Specified in seconds |
|
confirmationDelay |
Time before the booking when the client receives the first confirmation message. Specified in seconds |
|
confirmationRepetitions |
Number of messages sent to the client for booking confirmation, excluding the first |
|
confirmationRepetitionsInterval |
Interval between booking confirmation messages. Specified in seconds |
|
confirmationCounterDelay |
Time before the booking after which the counter for unconfirmed bookings lights up. Specified in seconds |
Code Examples
How to Use Examples in Documentation
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"id":10,"fields":{"name":"New Name","description":"New Description","typeId":1,"isMain":"N","isInfoNotificationOn":"Y","templateTypeInfo":"inanimate","isConfirmationNotificationOn":"Y","templateTypeConfirmation":"animate","isReminderNotificationOn":"Y","templateTypeReminder":"base","isFeedbackNotificationOn":"N","templateTypeFeedback":"animate","isDelayedNotificationOn":"N","templateTypeDelayed":"animate","infoDelay":300,"reminderDelay":-1,"delayedDelay":300,"delayedCounterDelay":7200,"confirmationDelay":86400,"confirmationRepetitions":0,"confirmationRepetitionsInterval":0,"confirmationCounterDelay":7200}}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/booking.v1.resource.update
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"id":10,"fields":{"name":"New Name","description":"New Description","typeId":1,"isMain":"N","isInfoNotificationOn":"Y","templateTypeInfo":"inanimate","isConfirmationNotificationOn":"Y","templateTypeConfirmation":"animate","isReminderNotificationOn":"Y","templateTypeReminder":"base","isFeedbackNotificationOn":"N","templateTypeFeedback":"animate","isDelayedNotificationOn":"N","templateTypeDelayed":"animate","infoDelay":300,"reminderDelay":-1,"delayedDelay":300,"delayedCounterDelay":7200,"confirmationDelay":86400,"confirmationRepetitions":0,"confirmationRepetitionsInterval":0,"confirmationCounterDelay":7200},"auth":"**put_access_token_here**"}' \
https://**put_your_bitrix24_address**/rest/booking.v1.resource.update
try
{
const response = await $b24.callMethod(
"booking.v1.resource.update",
{
id: 10,
fields: {
name: "New Name",
description: "New Description",
typeId: 1,
isMain: "N",
isInfoNotificationOn: "Y",
templateTypeInfo: "inanimate",
isConfirmationNotificationOn: "Y",
templateTypeConfirmation: "animate",
isReminderNotificationOn: "Y",
templateTypeReminder: "base",
isFeedbackNotificationOn: "N",
templateTypeFeedback: "animate",
isDelayedNotificationOn: "N",
templateTypeDelayed: "animate",
infoDelay: 300,
reminderDelay: -1,
delayedDelay: 300,
delayedCounterDelay: 7200,
confirmationDelay: 86400,
confirmationRepetitions: 0,
confirmationRepetitionsInterval: 0,
confirmationCounterDelay: 7200
}
}
);
const result = response.getData().result;
console.dir(result);
}
catch( error )
{
console.error(error);
}
try {
$response = $b24Service
->core
->call(
'booking.v1.resource.update',
[
'id' => 10,
'fields' => [
'name' => 'New Name',
'description' => 'New Description',
'typeId' => 1,
'isMain' => 'N',
'isInfoNotificationOn' => 'Y',
'templateTypeInfo' => 'inanimate',
'isConfirmationNotificationOn' => 'Y',
'templateTypeConfirmation' => 'animate',
'isReminderNotificationOn' => 'Y',
'templateTypeReminder' => 'base',
'isFeedbackNotificationOn' => 'N',
'templateTypeFeedback' => 'animate',
'isDelayedNotificationOn' => 'N',
'templateTypeDelayed' => 'animate',
'infoDelay' => 300,
'reminderDelay' => -1,
'delayedDelay' => 300,
'delayedCounterDelay' => 7200,
'confirmationDelay' => 86400,
'confirmationRepetitions' => 0,
'confirmationRepetitionsInterval' => 0,
'confirmationCounterDelay' => 7200,
],
]
);
$result = $response
->getResponseData()
->getResult();
echo 'Success: ' . print_r($result, true);
// Your data processing logic
processData($result);
} catch (Throwable $e) {
error_log($e->getMessage());
echo 'Error updating resource: ' . $e->getMessage();
}
BX24.callMethod(
"booking.v1.resource.update",
{
id: 10,
fields: {
name: "New Name",
description: "New Description",
typeId: 1,
isMain: "N",
isInfoNotificationOn: "Y",
templateTypeInfo: "inanimate",
isConfirmationNotificationOn: "Y",
templateTypeConfirmation: "animate",
isReminderNotificationOn: "Y",
templateTypeReminder: "base",
isFeedbackNotificationOn: "N",
templateTypeFeedback: "animate",
isDelayedNotificationOn: "N",
templateTypeDelayed: "animate",
infoDelay: 300,
reminderDelay: -1,
delayedDelay: 300,
delayedCounterDelay: 7200,
confirmationDelay: 86400,
confirmationRepetitions: 0,
confirmationRepetitionsInterval: 0,
confirmationCounterDelay: 7200
}
},
result => {
if (result.error())
console.error(result.error());
else
console.dir(result.data());
}
);
require_once('crest.php');
$result = CRest::call(
'booking.v1.resource.update',
[
'id' => 10,
'fields' => [
'name' => 'New Name',
'description' => 'New Description',
'typeId' => 1,
'isMain' => 'N',
'isInfoNotificationOn' => 'Y',
'templateTypeInfo' => 'inanimate',
'isConfirmationNotificationOn' => 'Y',
'templateTypeConfirmation' => 'animate',
'isReminderNotificationOn' => 'Y',
'templateTypeReminder' => 'base',
'isFeedbackNotificationOn' => 'N',
'templateTypeFeedback' => 'animate',
'isDelayedNotificationOn' => 'N',
'templateTypeDelayed' => 'animate',
'infoDelay' => 300,
'reminderDelay' => -1,
'delayedDelay' => 300,
'delayedCounterDelay' => 7200,
'confirmationDelay' => 86400,
'confirmationRepetitions' => 0,
'confirmationRepetitionsInterval' => 0,
'confirmationCounterDelay' => 7200
]
]
);
echo '<PRE>';
print_r($result);
echo '</PRE>';
Response Handling
HTTP status: 200
{
"result": true,
"time": {
"start": 1724068028.331234,
"finish": 1724068028.726591,
"duration": 0.3953571319580078,
"processing": 0.13033390045166016,
"date_start": "2025-01-21T13:47:08+02:00",
"date_finish": "2025-01-21T13:47:08+02:00",
"operating": 0
}
}
Returned Data
|
Name |
Description |
|
result |
Root element of the response, contains |
|
time |
Information about the request execution time |
Error Handling
HTTP status: 400
{
"error": 1007,
"error_description": "Resource not found"
}
|
Name |
Description |
|
error |
String error code. It may consist of digits, Latin letters, and underscores |
|
error_description |
Textual description of the error. The description is not intended to be shown to the end user in its raw form |
Possible Error Codes
|
Code |
Description |
Value |
|
|
|
Required parameter not provided |
|
|
|
Non-existent resource |
|
|
|
Non-existent |
|
|
|
Incorrect field value |
Statuses and System Error Codes
HTTP Status: 20x, 40x, 50x
The errors described below may occur when calling any method.
|
Status |
Code |
Description |
|
|
|
An internal server error has occurred, please contact the server administrator or Bitrix24 technical support |
|
|
|
An internal server error has occurred, please contact the server administrator or Bitrix24 technical support |
|
|
|
The request intensity limit has been exceeded |
|
|
|
The current method is not allowed to be called using batch |
|
|
|
The maximum length of parameters passed to the batch method has been exceeded |
|
|
|
Invalid access token or webhook code |
|
|
|
The methods must be called using the HTTPS protocol |
|
|
|
The REST API is blocked due to overload. This is a manual individual block, to remove it you need to contact Bitrix24 technical support |
|
|
|
The REST API is available only on commercial plans |
|
|
|
The user whose access token or webhook was used to call the method lacks permissions |
|
|
|
The manifest is not available |
|
|
|
The request requires higher privileges than those provided by the webhook token |
|
|
|
The provided access token has expired |
|
|
|
The user does not have access to the application. This means that the application is installed, but the account administrator has allowed access to this application only for specific users |
|
|
|
The public part of the site is closed. To open the public part of the site on an on-premise installation, disable the option "Temporary closure of the public part of the site". Path to the setting: Desktop > Settings > Product Settings > Module Settings > Main Module > Temporary closure of the public part of the site |
Continue Learning
- Resource Types: Overview of Methods
- Add a New Resource booking.v1.resource.add
- Get resource booking.v1.resource.get
- Delete Resource booking.v1.resource.delete
- Get the list of resources booking.v1.resource.list