API Method: POST room

Creates a new room for the authenticated account.

URL:

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

Formats:

xml, json

HTTP Method(s):

POST

Parameters:

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

• jid Required. The node part of Jaconda ID aka Jabber ID of the room you are creating (What is it?).
• 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 -d "room[jid]=developers" https://jaconda.im/api/rooms.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>Developers</title>
  <updated-at type="datetime">2010-03-24T10:56:20Z</updated-at>
</room>