# Is there any documentation on the User/Mobile API?

**URL:** <https://meta.discourse.org/t/is-there-any-documentation-on-the-user-mobile-api/65081>\
**Category:** Product Support\
**Created:** [Juin 25, 2017, 5:18 UTC](https://meta.discourse.org/t/is-there-any-documentation-on-the-user-mobile-api/65081 "2017-06-25T05:18:23Z")\
**Posts on this page:** 1\
**Showing post:** 2

<div class="post-metadata">

**Author:** ![j.jaffeux](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/j.jaffeux/32/60297_2.png) [@j.jaffeux](https://meta.discourse.org/u/j.jaffeux)\
**Post date:** [Juin 26, 2017, 10:06 UTC](https://meta.discourse.org/t/is-there-any-documentation-on-the-user-mobile-api/65081/2 "2017-06-26T10:06:04Z")

</div>

The `HEAD /user-api-key/new` request you are seeing is not creating anything, it’s mostly to check the site exists and it has the correct auth API version.

As you can see if it’s a HEAD request we are returning early: [discourse/app/controllers/user\_api\_keys\_controller.rb at main · discourse/discourse · GitHub](https://github.com/discourse/discourse/blob/master/app/controllers/user_api_keys_controller.rb#L13)

On the mobile app auth is done with an `authToken` coming back from the site popup when you tap on `authorize` see: [DiscourseMobile/js/site\_manager.js at main · discourse/DiscourseMobile · GitHub](https://github.com/discourse/DiscourseMobile/blob/master/js/site_manager.js#L437)

Concerning the notifications, the documentation is here: [Discourse API Docs](http://docs.discourse.org/#tag/Notifications%2Fpaths%2F~1notifications.json%2Fget) (I do agree it’s probably incomplete, you might want to grep DiscourseMobile code for “/notifications”)

---

_[View the full topic](https://meta.discourse.org/t/is-there-any-documentation-on-the-user-mobile-api/65081)._
