Лучший способ обновить или создать существующего пользователя через API с подключенного клиента?

Я не такой эксперт, как некоторые, но я так думаю.

Мне это выглядит правильно. Лучшая и всегда актуальная документация — это Обратная разработка API Discourse.