Насколько актуальна документация API?

Портал документации генерируется из той же OpenAPI-спецификации, по которой работает боевой API, — поэтому описанные методы и структуры ответов соответствуют продакшену, а не «идеальной» версии из презентации. Каждый метод в справочнике содержит схему запроса, ответа и кодов ошибок. Если вы нашли расхождение между документацией и реальным поведением, напишите в поддержку — такие обращения разбираются как дефекты.