API Method: POST room

Creates a new room.

Path:

/api/v2/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.
• is_public Optional. Whether your room is public or private. Values can be true for public and false for private. Rooms are private by default.
• topic Optional. The topic of the room you are creating.
• greeting_text Optional. New people will be greeted with this text.

Usage examples:

$ curl -u api_token:x -d "room[jid]=developers" https://bigbang.jaconda.im/api/v2/rooms.xml

Response:

XML example:

<?xml version="1.0" encoding="UTF-8"?>
<room>
  <created-at type="datetime">2011-02-25T14:38:59+05:00</created-at>
  <greeting-text>Welcome to Developers chat. Type !help to see available commands.</greeting-text>
  <is-public type="boolean">false</is-public>
  <jid>developers</jid>
  <title>Developers</title>
  <topic nil="true"></topic>
  <updated-at type="datetime">2011-02-25T14:38:59+05:00</updated-at>
  <icon-url>https://jaconda.im/images/defaultJacondaIcon.png</icon-url>
</room>