Принципно, API функциите се използват при писането на снипети или в php файлове, когато се инклудват в снипети.
По-голямата част са описани във
wiki.modxcms.com
За добавяне на статии /или нов документ/ се ползван стандартни инструменти, като NewsEditor, News Manager, NewsPublisher. Разгледай кода в тях, нячина на ползване на атрибутите на документа, чрез API-функции. Атрибутите на документа са листвани тук:
http://wiki.modxcms.com/index.php/API:documentObject
Лесно може да се манипулира атрибута [template], както при създаването, така и при редактирането, а също и при извеждане, стига стойността да е коректна /т.е. да съществува такъв темплейт/.
Винаги е препоръчително да се ползват API функциите на MODx при писане на php код за MODx!