API Method: POST room's user

Invites a user to the room.

Path:

/api/v2/rooms/#{room_id}/presences.#{format}

Formats:

xml, json

HTTP Method(s):

POST

Parameters:

Note that all parameters are encapsulated within a presence array (see example)

  • user_id Required. The id of the user.

Usage examples:

$ curl -u api_token:x -d "presence[user_id]=18265" https://bigbang.jaconda.im/api/v2/rooms/developers/presences.xml

Response:

XML example:

<?xml version="1.0" encoding="UTF-8"?>
<presence>
  <created-at type="datetime">2011-02-25T17:55:08+05:00</created-at>
  <id type="integer">31470</id>
  <is-jabber-paused type="boolean">false</is-jabber-paused>
  <jabber-paused-at type="datetime" nil="true"></jabber-paused-at>
  <jabber-paused-till type="datetime" nil="true"></jabber-paused-till>
  <jabber-status nil="true"></jabber-status>
  <updated-at type="datetime">2011-02-25T17:55:08+05:00</updated-at>
  <web-status nil="true"></web-status>
</presence>