API Method: PUT room

Updates the room identified by its integer id. Must be owned by the authenticated account.

URL:

https://jaconda.im/api/rooms/#{room_id}.#{format}

Formats:

xml, json

HTTP Method(s):

PUT, POST (with the added parameter _method=PUT)

Parameters:

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

• title Optional. The title of the room you are creating. This will be displayed in your friends' contact lists.
• is_public Optional. Whether your room is public or private. Values can be true for public and false for private. Rooms are public by default.
• status_message Optional. The status message of the room you are creating. This will be displayed in your friends' contact lists.
• greeting_text Optional. New people will be greeted with this text.

Usage examples:

cURL:

$ curl -u api_token:x -X PUT -d "room[title]=Designers" https://jaconda.im/api/rooms/3.xml

Response:

XML example:

<?xml version="1.0" encoding="UTF-8"?>
<room>
  <account-id type="integer">1</account-id>
  <created-at type="datetime">2010-03-24T10:56:20Z</created-at>
  <greeting-text>Hi, welcome to Developers. Type !help for a list of commands.</greeting-text>
  <id type="integer">3</id>
  <is-public type="boolean">true</is-public>
  <jid>developers</jid>
  <status-message>Available</status-message>
  <title>Designers</title>
  <updated-at type="datetime">2010-03-24T10:56:20Z</updated-at>
</room>