При работе с API очень удобно использовать специально созданное бесплатное приложение, которое выводит документацию в вашем портале Битрикс24.

Установив такое приложение, вы будете постоянно иметь "под рукой" актуальную версию REST API.

Приложение позволяет выполнять код, приведённые в доке, копировать его в панель и видоизменять под ваши задачи.