Skip to content
This repository has been archived by the owner on Apr 15, 2020. It is now read-only.

Chat API (REST SSE) for Openfire Documentation

Dele Olajide edited this page Feb 24, 2017 · 2 revisions

Access

[ Jump to Models ]

Table of Contents

get /restapi/v1/archive/messages/unread/{jid}

Retrieve all unread chat messages delivered offline (restapiV1ArchiveMessagesUnreadJidGet)

Path parameters

jid (required)

Path Parameter —

Return type

MsgArchiveEntity

Example data

Content-Type: application/json

{
  "jid" : "aeiou",
  "count" : 123
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

  • application/json
  • application/xml

Responses

200

OK MsgArchiveEntity


delete /restapi/v1/bookmarks/{bookmarkID}

(restapiV1BookmarksBookmarkIDDelete)

Path parameters

bookmarkID (required)

Path Parameter —

Responses

200

OK


get /restapi/v1/bookmarks/{bookmarkID}

(restapiV1BookmarksBookmarkIDGet)

Path parameters

bookmarkID (required)

Path Parameter —

Return type

Bookmark

Example data

Content-Type: application/json

{
  "bookmarkID" : 123,
  "globalBookmark" : true,
  "propertyNames" : "{}",
  "name" : "aeiou",
  "property" : "aeiou",
  "groups" : [ "aeiou" ],
  "type" : "aeiou",
  "value" : "aeiou",
  "properties" : [ "aeiou" ],
  "users" : [ "aeiou" ]
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

  • application/json
  • application/xml

Responses

200

OK Bookmark


delete /restapi/v1/bookmarks/{bookmarkID}/property

(restapiV1BookmarksBookmarkIDPropertyDelete)

Path parameters

bookmarkID (required)

Path Parameter —

Query parameters

name (required)

Query Parameter —

Return type

Bookmark

Example data

Content-Type:

Responses

200

OK Bookmark


get /restapi/v1/bookmarks/{bookmarkID}/property

(restapiV1BookmarksBookmarkIDPropertyGet)

Path parameters

bookmarkID (required)

Path Parameter —

Query parameters

name (required)

Query Parameter —

Return type

String

Example data

Content-Type:

Responses

200

OK String


put /restapi/v1/bookmarks/{bookmarkID}/property

(restapiV1BookmarksBookmarkIDPropertyPut)

Path parameters

bookmarkID (required)

Path Parameter —

Query parameters

name (required)

Query Parameter —

value (required)

Query Parameter —

Return type

Bookmark

Example data

Content-Type:

Responses

200

OK Bookmark


put /restapi/v1/bookmarks/{bookmarkID}

(restapiV1BookmarksBookmarkIDPut)

Path parameters

bookmarkID (required)

Path Parameter —

Request body

body Bookmark (required)

Body Parameter —

Return type

Bookmark

Example data

Content-Type:

Responses

200

OK Bookmark


get /restapi/v1/bookmarks/

(restapiV1BookmarksGet)

Return type

Bookmarks

Example data

Content-Type: application/json

{
  "bookmarks" : [ {
    "bookmarkID" : 123,
    "globalBookmark" : true,
    "propertyNames" : "{}",
    "name" : "aeiou",
    "property" : "aeiou",
    "groups" : [ "aeiou" ],
    "type" : "aeiou",
    "value" : "aeiou",
    "properties" : [ "aeiou" ],
    "users" : [ "aeiou" ]
  } ]
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

  • application/json
  • application/xml

Responses

200

OK Bookmarks


post /restapi/v1/bookmarks

(restapiV1BookmarksPost)

Request body

body Bookmark (required)

Body Parameter —

Return type

Bookmark

Example data

Content-Type:

Responses

200

OK Bookmark


get /restapi/v1/bookmarks/user/{userID}

(restapiV1BookmarksUserUserIDGet)

Path parameters

userID (required)

Path Parameter —

Return type

Bookmarks

Example data

Content-Type:

Responses

200

OK Bookmarks


get /restapi/v1/bookmarks/userid

(restapiV1BookmarksUseridGet)

Query parameters

userid (required)

Query Parameter —

Return type

String

Example data

Content-Type:

Responses

200

OK String


get /restapi/v1/chatrooms

(restapiV1ChatroomsGet)

Query parameters

expandGroups (optional)

Query Parameter —

search (required)

Query Parameter —

servicename (optional)

Query Parameter —

type (optional)

Query Parameter —

Return type

MUCRoomEntities

Example data

Content-Type: application/json

{
  "mucRooms" : [ {
    "registrationEnabled" : true,
    "maxUsers" : 123,
    "moderated" : true,
    "subject" : "aeiou",
    "description" : "aeiou",
    "owners" : [ "aeiou" ],
    "password" : "aeiou",
    "outcastGroups" : [ "aeiou" ],
    "ownerGroups" : [ "aeiou" ],
    "logEnabled" : true,
    "members" : [ "aeiou" ],
    "canAnyoneDiscoverJID" : true,
    "canOccupantsChangeSubject" : true,
    "canChangeNickname" : true,
    "memberGroups" : [ "aeiou" ],
    "persistent" : true,
    "adminGroups" : [ "aeiou" ],
    "publicRoom" : true,
    "outcasts" : [ "aeiou" ],
    "broadcastPresenceRoles" : [ "aeiou" ],
    "creationDate" : "{}",
    "membersOnly" : true,
    "canOccupantsInvite" : true,
    "roomName" : "aeiou",
    "loginRestrictedToNickname" : true,
    "modificationDate" : "{}",
    "naturalName" : "aeiou",
    "admins" : [ "aeiou" ]
  } ]
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

  • application/json
  • application/xml

Responses

200

OK MUCRoomEntities


post /restapi/v1/chatrooms

(restapiV1ChatroomsPost)

Request body

body MUCRoomEntity (required)

Body Parameter —

Query parameters

servicename (optional)

Query Parameter —

Responses

201

Created


delete /restapi/v1/chatrooms/{roomName}/admins/group/{groupname}

(restapiV1ChatroomsRoomNameAdminsGroupGroupnameDelete)

Path parameters

groupname (required)

Path Parameter —

roomName (required)

Path Parameter —

Query parameters

servicename (optional)

Query Parameter —

Responses

200

OK


post /restapi/v1/chatrooms/{roomName}/admins/group/{groupname}

(restapiV1ChatroomsRoomNameAdminsGroupGroupnamePost)

Path parameters

groupname (required)

Path Parameter —

roomName (required)

Path Parameter —

Query parameters

servicename (optional)

Query Parameter —

Responses

201

Created


delete /restapi/v1/chatrooms/{roomName}/admins/{jid}

(restapiV1ChatroomsRoomNameAdminsJidDelete)

Path parameters

jid (required)

Path Parameter —

roomName (required)

Path Parameter —

Query parameters

servicename (optional)

Query Parameter —

Responses

200

OK


post /restapi/v1/chatrooms/{roomName}/admins/{jid}

(restapiV1ChatroomsRoomNameAdminsJidPost)

Path parameters

jid (required)

Path Parameter —

roomName (required)

Path Parameter —

Query parameters

servicename (optional)

Query Parameter —

Responses

201

Created


delete /restapi/v1/chatrooms/{roomName}

(restapiV1ChatroomsRoomNameDelete)

Path parameters

roomName (required)

Path Parameter —

Query parameters

servicename (optional)

Query Parameter —

Responses

200

OK


get /restapi/v1/chatrooms/{roomName}

(restapiV1ChatroomsRoomNameGet)

Path parameters

roomName (required)

Path Parameter —

Query parameters

expandGroups (optional)

Query Parameter —

servicename (optional)

Query Parameter —

Return type

MUCRoomEntity

Example data

Content-Type: application/json

{
  "registrationEnabled" : true,
  "maxUsers" : 123,
  "moderated" : true,
  "subject" : "aeiou",
  "description" : "aeiou",
  "owners" : [ "aeiou" ],
  "password" : "aeiou",
  "outcastGroups" : [ "aeiou" ],
  "ownerGroups" : [ "aeiou" ],
  "logEnabled" : true,
  "members" : [ "aeiou" ],
  "canAnyoneDiscoverJID" : true,
  "canOccupantsChangeSubject" : true,
  "canChangeNickname" : true,
  "memberGroups" : [ "aeiou" ],
  "persistent" : true,
  "adminGroups" : [ "aeiou" ],
  "publicRoom" : true,
  "outcasts" : [ "aeiou" ],
  "broadcastPresenceRoles" : [ "aeiou" ],
  "creationDate" : "{}",
  "membersOnly" : true,
  "canOccupantsInvite" : true,
  "roomName" : "aeiou",
  "loginRestrictedToNickname" : true,
  "modificationDate" : "{}",
  "naturalName" : "aeiou",
  "admins" : [ "aeiou" ]
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

  • application/json
  • application/xml

Responses

200

OK MUCRoomEntity


delete /restapi/v1/chatrooms/{roomName}/members/group/{groupname}

(restapiV1ChatroomsRoomNameMembersGroupGroupnameDelete)

Path parameters

groupname (required)

Path Parameter —

roomName (required)

Path Parameter —

Query parameters

servicename (optional)

Query Parameter —

Responses

200

OK


post /restapi/v1/chatrooms/{roomName}/members/group/{groupname}

(restapiV1ChatroomsRoomNameMembersGroupGroupnamePost)

Path parameters

groupname (required)

Path Parameter —

roomName (required)

Path Parameter —

Query parameters

servicename (optional)

Query Parameter —

Responses

201

Created


delete /restapi/v1/chatrooms/{roomName}/members/{jid}

(restapiV1ChatroomsRoomNameMembersJidDelete)

Path parameters

jid (required)

Path Parameter —

roomName (required)

Path Parameter —

Query parameters

servicename (optional)

Query Parameter —

Responses

200

OK


post /restapi/v1/chatrooms/{roomName}/members/{jid}

(restapiV1ChatroomsRoomNameMembersJidPost)

Path parameters

jid (required)

Path Parameter —

roomName (required)

Path Parameter —

Query parameters

servicename (optional)

Query Parameter —

Responses

201

Created


get /restapi/v1/chatrooms/{roomName}/occupants

(restapiV1ChatroomsRoomNameOccupantsGet)

Path parameters

roomName (required)

Path Parameter —

Query parameters

servicename (optional)

Query Parameter —

Return type

OccupantEntities

Example data

Content-Type: application/json

{
  "occupants" : [ {
    "role" : "aeiou",
    "jid" : "aeiou",
    "affiliation" : "aeiou"
  } ]
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

  • application/json
  • application/xml

Responses

200

OK OccupantEntities


delete /restapi/v1/chatrooms/{roomName}/outcasts/group/{groupname}

(restapiV1ChatroomsRoomNameOutcastsGroupGroupnameDelete)

Path parameters

groupname (required)

Path Parameter —

roomName (required)

Path Parameter —

Query parameters

servicename (optional)

Query Parameter —

Responses

200

OK


post /restapi/v1/chatrooms/{roomName}/outcasts/group/{groupname}

(restapiV1ChatroomsRoomNameOutcastsGroupGroupnamePost)

Path parameters

groupname (required)

Path Parameter —

roomName (required)

Path Parameter —

Query parameters

servicename (optional)

Query Parameter —

Responses

201

Created


delete /restapi/v1/chatrooms/{roomName}/outcasts/{jid}

(restapiV1ChatroomsRoomNameOutcastsJidDelete)

Path parameters

jid (required)

Path Parameter —

roomName (required)

Path Parameter —

Query parameters

servicename (optional)

Query Parameter —

Responses

200

OK


post /restapi/v1/chatrooms/{roomName}/outcasts/{jid}

(restapiV1ChatroomsRoomNameOutcastsJidPost)

Path parameters

jid (required)

Path Parameter —

roomName (required)

Path Parameter —

Query parameters

servicename (optional)

Query Parameter —

Responses

201

Created


delete /restapi/v1/chatrooms/{roomName}/owners/group/{groupname}

(restapiV1ChatroomsRoomNameOwnersGroupGroupnameDelete)

Path parameters

groupname (required)

Path Parameter —

roomName (required)

Path Parameter —

Query parameters

servicename (optional)

Query Parameter —

Responses

200

OK


post /restapi/v1/chatrooms/{roomName}/owners/group/{groupname}

(restapiV1ChatroomsRoomNameOwnersGroupGroupnamePost)

Path parameters

groupname (required)

Path Parameter —

roomName (required)

Path Parameter —

Query parameters

servicename (optional)

Query Parameter —

Responses

201

Created


delete /restapi/v1/chatrooms/{roomName}/owners/{jid}

(restapiV1ChatroomsRoomNameOwnersJidDelete)

Path parameters

jid (required)

Path Parameter —

roomName (required)

Path Parameter —

Query parameters

servicename (optional)

Query Parameter —

Responses

200

OK


post /restapi/v1/chatrooms/{roomName}/owners/{jid}

(restapiV1ChatroomsRoomNameOwnersJidPost)

Path parameters

jid (required)

Path Parameter —

roomName (required)

Path Parameter —

Query parameters

servicename (optional)

Query Parameter —

Responses

201

Created


get /restapi/v1/chatrooms/{roomName}/participants

(restapiV1ChatroomsRoomNameParticipantsGet)

Path parameters

roomName (required)

Path Parameter —

Query parameters

servicename (optional)

Query Parameter —

Return type

ParticipantEntities

Example data

Content-Type: application/json

{
  "participants" : [ {
    "role" : "aeiou",
    "jid" : "aeiou",
    "affiliation" : "aeiou"
  } ]
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

  • application/json
  • application/xml

Responses

200

OK ParticipantEntities


put /restapi/v1/chatrooms/{roomName}

(restapiV1ChatroomsRoomNamePut)

Path parameters

roomName (required)

Path Parameter —

Request body

body MUCRoomEntity (required)

Body Parameter —

Query parameters

servicename (optional)

Query Parameter —

Responses

200

OK


get /restapi/v1/groups

(restapiV1GroupsGet)

Return type

GroupEntities

Example data

Content-Type: application/json

{
  "groups" : [ {
    "members" : [ "aeiou" ],
    "name" : "aeiou",
    "description" : "aeiou",
    "admins" : [ "aeiou" ]
  } ]
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

  • application/json
  • application/xml

Responses

200

OK GroupEntities


delete /restapi/v1/groups/{groupName}

(restapiV1GroupsGroupNameDelete)

Path parameters

groupName (required)

Path Parameter —

Responses

200

OK


get /restapi/v1/groups/{groupName}

(restapiV1GroupsGroupNameGet)

Path parameters

groupName (required)

Path Parameter —

Return type

GroupEntity

Example data

Content-Type: application/json

{
  "members" : [ "aeiou" ],
  "name" : "aeiou",
  "description" : "aeiou",
  "admins" : [ "aeiou" ]
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

  • application/json
  • application/xml

Responses

200

OK GroupEntity


put /restapi/v1/groups/{groupName}

(restapiV1GroupsGroupNamePut)

Path parameters

groupName (required)

Path Parameter —

Request body

body GroupEntity (required)

Body Parameter —

Responses

200

OK


post /restapi/v1/groups

(restapiV1GroupsPost)

Request body

body GroupEntity (required)

Body Parameter —

Responses

201

Created


delete /restapi/v1/lockouts/{username}

(restapiV1LockoutsUsernameDelete)

Path parameters

username (required)

Path Parameter —

Responses

200

OK


post /restapi/v1/lockouts/{username}

(restapiV1LockoutsUsernamePost)

Path parameters

username (required)

Path Parameter —

Responses

201

Created


post /restapi/v1/messages/users

(restapiV1MessagesUsersPost)

Request body

body MessageEntity (required)

Body Parameter —

Responses

201

Created


get /restapi/v1/sessions

(restapiV1SessionsGet)

Return type

SessionEntities

Example data

Content-Type: application/json

{
  "sessions" : [ {
    "hostName" : "aeiou",
    "sessionStatus" : "aeiou",
    "lastActionDate" : "{}",
    "sessionId" : "aeiou",
    "creationDate" : "{}",
    "priority" : 123,
    "secure" : true,
    "node" : "aeiou",
    "ressource" : "aeiou",
    "presenceMessage" : "aeiou",
    "hostAddress" : "aeiou",
    "presenceStatus" : "aeiou",
    "username" : "aeiou"
  } ]
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

  • application/json
  • application/xml

Responses

200

OK SessionEntities


delete /restapi/v1/sessions/{username}

(restapiV1SessionsUsernameDelete)

Path parameters

username (required)

Path Parameter —

Responses

200

OK


get /restapi/v1/sessions/{username}

(restapiV1SessionsUsernameGet)

Path parameters

username (required)

Path Parameter —

Return type

SessionEntities

Example data

Content-Type: application/json

{
  "sessions" : [ {
    "hostName" : "aeiou",
    "sessionStatus" : "aeiou",
    "lastActionDate" : "{}",
    "sessionId" : "aeiou",
    "creationDate" : "{}",
    "priority" : 123,
    "secure" : true,
    "node" : "aeiou",
    "ressource" : "aeiou",
    "presenceMessage" : "aeiou",
    "hostAddress" : "aeiou",
    "presenceStatus" : "aeiou",
    "username" : "aeiou"
  } ]
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

  • application/json
  • application/xml

Responses

200

OK SessionEntities


post /restapi/v1/sipaccounts/close/{username}

(restapiV1SipaccountsCloseUsernamePost)

Path parameters

username (required)

Path Parameter —

Responses

200

OK

400

Bad Request


get /restapi/v1/sipaccounts/extension/{extension}

(restapiV1SipaccountsExtensionExtensionGet)

Path parameters

extension (required)

Path Parameter —

Return type

SipAccount

Example data

Content-Type: application/json

{
  "sipUsername" : "aeiou",
  "server" : "aeiou",
  "stunServer" : "aeiou",
  "voiceMailNumber" : "aeiou",
  "displayName" : "aeiou",
  "useStun" : true,
  "enabled" : true,
  "stunPort" : "aeiou",
  "cachedSize" : 123,
  "password" : "aeiou",
  "authUsername" : "aeiou",
  "promptCredentials" : true,
  "outboundproxy" : "aeiou",
  "status" : "aeiou",
  "username" : "aeiou"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

  • application/json
  • application/xml

Responses

200

OK SipAccount


get /restapi/v1/sipaccounts

(restapiV1SipaccountsGet)

Query parameters

count (optional)

Query Parameter —

start (optional)

Query Parameter —

Return type

SipAccounts

Example data

Content-Type: application/json

{
  "accounts" : [ {
    "sipUsername" : "aeiou",
    "server" : "aeiou",
    "stunServer" : "aeiou",
    "voiceMailNumber" : "aeiou",
    "displayName" : "aeiou",
    "useStun" : true,
    "enabled" : true,
    "stunPort" : "aeiou",
    "cachedSize" : 123,
    "password" : "aeiou",
    "authUsername" : "aeiou",
    "promptCredentials" : true,
    "outboundproxy" : "aeiou",
    "status" : "aeiou",
    "username" : "aeiou"
  } ]
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

  • application/json
  • application/xml

Responses

200

OK SipAccounts


post /restapi/v1/sipaccounts/open/{username}

(restapiV1SipaccountsOpenUsernamePost)

Path parameters

username (required)

Path Parameter —

Responses

200

OK

400

Bad Request


post /restapi/v1/sipaccounts

(restapiV1SipaccountsPost)

Request body

body SipAccount (required)

Body Parameter —

Responses

200

OK

201

Created


delete /restapi/v1/sipaccounts/{username}

(restapiV1SipaccountsUsernameDelete)

Path parameters

username (required)

Path Parameter —

Responses

200

OK

400

Bad Request


get /restapi/v1/sipaccounts/username/{username}

(restapiV1SipaccountsUsernameUsernameGet)

Path parameters

username (required)

Path Parameter —

Return type

SipAccount

Example data

Content-Type: application/json

{
  "sipUsername" : "aeiou",
  "server" : "aeiou",
  "stunServer" : "aeiou",
  "voiceMailNumber" : "aeiou",
  "displayName" : "aeiou",
  "useStun" : true,
  "enabled" : true,
  "stunPort" : "aeiou",
  "cachedSize" : 123,
  "password" : "aeiou",
  "authUsername" : "aeiou",
  "promptCredentials" : true,
  "outboundproxy" : "aeiou",
  "status" : "aeiou",
  "username" : "aeiou"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

  • application/json
  • application/xml

Responses

200

OK SipAccount


get /restapi/v1/system/properties

(restapiV1SystemPropertiesGet)

Return type

SystemProperties

Example data

Content-Type: application/json

{
  "properties" : [ {
    "value" : "aeiou",
    "key" : "aeiou"
  } ]
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

  • application/json
  • application/xml

Responses

200

OK SystemProperties


post /restapi/v1/system/properties

(restapiV1SystemPropertiesPost)

Request body

body SystemProperty (required)

Body Parameter —

Responses

201

Created


delete /restapi/v1/system/properties/{propertyKey}

(restapiV1SystemPropertiesPropertyKeyDelete)

Path parameters

propertyKey (required)

Path Parameter —

Responses

200

OK


get /restapi/v1/system/properties/{propertyKey}

(restapiV1SystemPropertiesPropertyKeyGet)

Path parameters

propertyKey (required)

Path Parameter —

Return type

SystemProperty

Example data

Content-Type: application/json

{
  "value" : "aeiou",
  "key" : "aeiou"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

  • application/json
  • application/xml

Responses

200

OK SystemProperty


put /restapi/v1/system/properties/{propertyKey}

(restapiV1SystemPropertiesPropertyKeyPut)

Path parameters

propertyKey (required)

Path Parameter —

Request body

body SystemProperty (required)

Body Parameter —

Responses

200

OK


get /restapi/v1/system/statistics/sessions

(restapiV1SystemStatisticsSessionsGet)

Return type

SessionsCount

Example data

Content-Type: application/json

{
  "localSessions" : 123,
  "clusterSessions" : 123
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

  • application/json
  • application/xml

Responses

200

OK SessionsCount


get /restapi/v1/users

(restapiV1UsersGet)

Query parameters

propertyKey (required)

Query Parameter —

propertyValue (required)

Query Parameter —

search (required)

Query Parameter —

Return type

UserEntities

Example data

Content-Type: application/json

{
  "users" : [ {
    "password" : "aeiou",
    "name" : "aeiou",
    "show" : "aeiou",
    "email" : "aeiou",
    "properties" : [ {
      "value" : "aeiou",
      "key" : "aeiou"
    } ],
    "status" : "aeiou",
    "username" : "aeiou"
  } ]
}

Example data

Content-Type: application/xml

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

  • application/json
  • application/xml

Responses

200

OK UserEntities


post /restapi/v1/users

(restapiV1UsersPost)

Request body

body UserEntity (required)

Body Parameter —

Responses

201

Created


delete /restapi/v1/users/{username}

(restapiV1UsersUsernameDelete)

Path parameters

username (required)

Path Parameter —

Responses

200

OK


get /restapi/v1/users/{username}

(restapiV1UsersUsernameGet)

Path parameters

username (required)

Path Parameter —

Return type

UserEntity

Example data

Content-Type: application/json

{
  "password" : "aeiou",
  "name" : "aeiou",
  "show" : "aeiou",
  "email" : "aeiou",
  "properties" : [ {
    "value" : "aeiou",
    "key" : "aeiou"
  } ],
  "status" : "aeiou",
  "username" : "aeiou"
}

Example data

Content-Type: application/xml

  string
  string
  string
  string
  string
  string

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

  • application/json
  • application/xml

Responses

200

OK UserEntity


delete /restapi/v1/users/{username}/groups

(restapiV1UsersUsernameGroupsDelete)

Path parameters

username (required)

Path Parameter —

Request body

body UserGroupsEntity (required)

Body Parameter —

Responses

200

OK


get /restapi/v1/users/{username}/groups

(restapiV1UsersUsernameGroupsGet)

Path parameters

username (required)

Path Parameter —

Return type

UserGroupsEntity

Example data

Content-Type: application/json

{
  "groupNames" : [ "aeiou" ]
}

Example data

Content-Type: application/xml

  string

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

  • application/json
  • application/xml

Responses

200

OK UserGroupsEntity


delete /restapi/v1/users/{username}/groups/{groupName}

(restapiV1UsersUsernameGroupsGroupNameDelete)

Path parameters

groupName (required)

Path Parameter —

username (required)

Path Parameter —

Responses

200

OK


post /restapi/v1/users/{username}/groups/{groupName}

(restapiV1UsersUsernameGroupsGroupNamePost)

Path parameters

groupName (required)

Path Parameter —

username (required)

Path Parameter —

Responses

201

Created


post /restapi/v1/users/{username}/groups

(restapiV1UsersUsernameGroupsPost)

Path parameters

username (required)

Path Parameter —

Request body

body UserGroupsEntity (required)

Body Parameter —

Responses

201

Created


put /restapi/v1/users/{username}

(restapiV1UsersUsernamePut)

Path parameters

username (required)

Path Parameter —

Request body

body UserEntity (required)

Body Parameter —

Responses

200

OK


get /restapi/v1/users/{username}/roster

(restapiV1UsersUsernameRosterGet)

Path parameters

username (required)

Path Parameter —

Return type

RosterEntities

Example data

Content-Type: application/json

{
  "roster" : [ {
    "jid" : "aeiou",
    "subscriptionType" : 123,
    "nickname" : "aeiou",
    "show" : "aeiou",
    "groups" : [ "aeiou" ],
    "status" : "aeiou"
  } ]
}

Example data

Content-Type: application/xml

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

  • application/json
  • application/xml

Responses

200

OK RosterEntities


post /restapi/v1/users/{username}/roster

(restapiV1UsersUsernameRosterPost)

Path parameters

username (required)

Path Parameter —

Request body

body RosterItemEntity (required)

Body Parameter —

Responses

201

Created


delete /restapi/v1/users/{username}/roster/{rosterJid}

(restapiV1UsersUsernameRosterRosterJidDelete)

Path parameters

rosterJid (required)

Path Parameter —

username (required)

Path Parameter —

Responses

200

OK


put /restapi/v1/users/{username}/roster/{rosterJid}

(restapiV1UsersUsernameRosterRosterJidPut)

Path parameters

rosterJid (required)

Path Parameter —

username (required)

Path Parameter —

Request body

body RosterItemEntity (required)

Body Parameter —

Responses

200

OK


get /restapi/v1/userservice

(restapiV1UserserviceGet)

Responses

200

OK


post /restapi/v1/userservice

(restapiV1UserservicePost)

Responses

204

No Content


get /restapi/v1/chat/contacts

Retrieve roster contacts (restapiV1ChatContactsGet)

Return type

RosterEntities

Example data

Content-Type: application/json

{
  "roster" : [ {
    "jid" : "aeiou",
    "subscriptionType" : 123,
    "nickname" : "aeiou",
    "show" : "aeiou",
    "groups" : [ "aeiou" ],
    "status" : "aeiou"
  } ]
}

Example data

Content-Type: application/xml

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

  • application/json
  • application/xml

Responses

200

OK RosterEntities


post /restapi/v1/chat/contacts

Add a new roster contact (restapiV1ChatContactsPost)

Request body

body RosterItemEntity (required)

Body Parameter —

Responses

201

Created


delete /restapi/v1/chat/contacts/{rosterJid}

Remove contact from roster (restapiV1ChatContactsRosterJidDelete)

Path parameters

rosterJid (required)

Path Parameter —

Responses

201

Created


put /restapi/v1/chat/contacts/{rosterJid}

Update existing roster contact (restapiV1ChatContactsRosterJidPut)

Path parameters

rosterJid (required)

Path Parameter —

Request body

body RosterItemEntity (required)

Body Parameter —

Responses

201

Created


get /restapi/v1/chat/messages

Retrieve old archived mesages (restapiV1ChatMessagesGet)

This operation requires the monitoring plugin to work. It performs a database seaach using the supplied parameters or list of keywords

Query parameters

end (required)

Query Parameter —

keywords (required)

Query Parameter —

room (required)

Query Parameter —

service (required)

Query Parameter —

start (required)

Query Parameter —

to (required)

Query Parameter —

Return type

Conversations

Example data

Content-Type: application/json

{
  "conversations" : [ {
    "participantList" : [ "aeiou" ],
    "external" : true,
    "participations" : [ {
      "left" : "{}",
      "joined" : "{}",
      "nickname" : "aeiou"
    } ],
    "messageCount" : 123,
    "conversationID" : 123,
    "conversationParticipants" : [ "aeiou" ],
    "messages" : [ {
      "sentDate" : "{}",
      "conversationID" : 123,
      "stanza" : "aeiou",
      "fromJID" : {
        "node" : "aeiou",
        "resource" : "aeiou",
        "domain" : "aeiou"
      },
      "from" : "aeiou",
      "to" : "aeiou",
      "body" : "aeiou",
      "roomEvent" : true,
      "toJID" : ""
    } ],
    "lastActivity" : "{}",
    "room" : "",
    "startDate" : "{}",
    "chatRoom" : "aeiou",
    "participants" : [ "" ]
  } ]
}

Example data

Content-Type: application/xml

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

  • application/json
  • application/xml

Responses

200

OK Conversations


post /restapi/v1/chat/messages/{to}

Post a chat or groupchat message (restapiV1ChatMessagesToPost)

Path parameters

to (required)

Path Parameter —

Request body

body string (required)

Body Parameter —

Responses

200

OK


post /restapi/v1/chat/presence

Broadcast own presence to others (restapiV1ChatPresencePost)

Query parameters

show (required)

Query Parameter —

status (required)

Query Parameter —

Responses

200

OK


get /restapi/v1/chat/rooms

Retrieve a list of groupchat/muc rooms (restapiV1ChatRoomsGet)

Query parameters

expandGroups (optional)

Query Parameter —

search (required)

Query Parameter —

servicename (optional)

Query Parameter —

type (optional)

Query Parameter —

Return type

MUCRoomEntities

Example data

Content-Type: application/json

{
  "mucRooms" : [ {
    "registrationEnabled" : true,
    "maxUsers" : 123,
    "moderated" : true,
    "subject" : "aeiou",
    "description" : "aeiou",
    "owners" : [ "aeiou" ],
    "password" : "aeiou",
    "outcastGroups" : [ "aeiou" ],
    "ownerGroups" : [ "aeiou" ],
    "logEnabled" : true,
    "members" : [ "aeiou" ],
    "canAnyoneDiscoverJID" : true,
    "canOccupantsChangeSubject" : true,
    "canChangeNickname" : true,
    "memberGroups" : [ "aeiou" ],
    "persistent" : true,
    "adminGroups" : [ "aeiou" ],
    "publicRoom" : true,
    "outcasts" : [ "aeiou" ],
    "broadcastPresenceRoles" : [ "aeiou" ],
    "creationDate" : "{}",
    "membersOnly" : true,
    "canOccupantsInvite" : true,
    "roomName" : "aeiou",
    "loginRestrictedToNickname" : true,
    "modificationDate" : "{}",
    "naturalName" : "aeiou",
    "admins" : [ "aeiou" ]
  } ]
}

Example data

Content-Type: application/xml

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

  • application/json
  • application/xml

Responses

200

OK MUCRoomEntities


delete /restapi/v1/chat/rooms/{roomName}

Leave a groupchat/muc room (restapiV1ChatRoomsRoomNameDelete)

Path parameters

roomName (required)

Path Parameter —

Query parameters

service (optional)

Query Parameter —

Responses

200

OK


get /restapi/v1/chat/rooms/{roomName}

Retrieve a specific groupchat/muc room (restapiV1ChatRoomsRoomNameGet)

Path parameters

roomName (required)

Path Parameter —

Query parameters

expandGroups (optional)

Query Parameter —

servicename (optional)

Query Parameter —

Return type

MUCRoomEntity

Example data

Content-Type: application/json

{
  "registrationEnabled" : true,
  "maxUsers" : 123,
  "moderated" : true,
  "subject" : "aeiou",
  "description" : "aeiou",
  "owners" : [ "aeiou" ],
  "password" : "aeiou",
  "outcastGroups" : [ "aeiou" ],
  "ownerGroups" : [ "aeiou" ],
  "logEnabled" : true,
  "members" : [ "aeiou" ],
  "canAnyoneDiscoverJID" : true,
  "canOccupantsChangeSubject" : true,
  "canChangeNickname" : true,
  "memberGroups" : [ "aeiou" ],
  "persistent" : true,
  "adminGroups" : [ "aeiou" ],
  "publicRoom" : true,
  "outcasts" : [ "aeiou" ],
  "broadcastPresenceRoles" : [ "aeiou" ],
  "creationDate" : "{}",
  "membersOnly" : true,
  "canOccupantsInvite" : true,
  "roomName" : "aeiou",
  "loginRestrictedToNickname" : true,
  "modificationDate" : "{}",
  "naturalName" : "aeiou",
  "admins" : [ "aeiou" ]
}

Example data

Content-Type: application/xml

  string
  string
  string
  true
  true
  true
  true
  not implemented io.swagger.models.properties.ObjectProperty@5e032f61
  string
  true
  true
  not implemented io.swagger.models.properties.BaseIntegerProperty@8cb7453e
  string
  string
  true
  true
  not implemented io.swagger.models.properties.ObjectProperty@5e032f61
  string
  string
  string
  string
  string
  string
  true
  true
  true
  string
  string

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

  • application/json
  • application/xml

Responses

200

OK MUCRoomEntity


post /restapi/v1/chat/rooms/{roomName}/{invitedJid}

Invite someone else to a groupchat/muc room (restapiV1ChatRoomsRoomNameInvitedJidPost)

Path parameters

invitedJid (required)

Path Parameter —

roomName (required)

Path Parameter —

Request body

body string (required)

Body Parameter —

Query parameters

service (optional)

Query Parameter —

Responses

200

OK


get /restapi/v1/chat/rooms/{roomName}/occupants

Retrieve a list of groupchat/muc room occupants (restapiV1ChatRoomsRoomNameOccupantsGet)

Path parameters

roomName (required)

Path Parameter —

Query parameters

servicename (optional)

Query Parameter —

Return type

OccupantEntities

Example data

Content-Type: application/json

{
  "occupants" : [ {
    "role" : "aeiou",
    "jid" : "aeiou",
    "affiliation" : "aeiou"
  } ]
}

Example data

Content-Type: application/xml

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

  • application/json
  • application/xml

Responses

200

OK OccupantEntities


get /restapi/v1/chat/rooms/{roomName}/participants

Retrieve a list of groupchat/muc room participants (restapiV1ChatRoomsRoomNameParticipantsGet)

Path parameters

roomName (required)

Path Parameter —

Query parameters

servicename (optional)

Query Parameter —

Return type

ParticipantEntities

Example data

Content-Type: application/json

{
  "participants" : [ {
    "role" : "aeiou",
    "jid" : "aeiou",
    "affiliation" : "aeiou"
  } ]
}

Example data

Content-Type: application/xml

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

  • application/json
  • application/xml

Responses

200

OK ParticipantEntities


post /restapi/v1/chat/rooms/{roomName}

Post a message to a groupchat/muc room (restapiV1ChatRoomsRoomNamePost)

Path parameters

roomName (required)

Path Parameter —

Request body

body string (required)

Body Parameter —

Query parameters

service (optional)

Query Parameter —

Responses

200

OK


put /restapi/v1/chat/rooms/{roomName}

Join a groupchat/muc room (restapiV1ChatRoomsRoomNamePut)

Path parameters

roomName (required)

Path Parameter —

Query parameters

service (optional)

Query Parameter —

Responses

200

OK


get /restapi/v1/chat/users

Search the user directory (restapiV1ChatUsersGet)

Query parameters

search (required)

Query Parameter —

Return type

UserEntities

Example data

Content-Type: application/json

{
  "users" : [ {
    "password" : "aeiou",
    "name" : "aeiou",
    "show" : "aeiou",
    "email" : "aeiou",
    "properties" : [ {
      "value" : "aeiou",
      "key" : "aeiou"
    } ],
    "status" : "aeiou",
    "username" : "aeiou"
  } ]
}

Example data

Content-Type: application/xml

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

  • application/json
  • application/xml

Responses

200

OK UserEntities


delete /restapi/v1/chat/users/{propertyName}

Remove own user profile property (restapiV1ChatUsersPropertyNameDelete)

Path parameters

propertyName (required)

Path Parameter —

Responses

200

OK


post /restapi/v1/chat/users/{propertyName}

Add or update own user profile property (restapiV1ChatUsersPropertyNamePost)

Path parameters

propertyName (required)

Path Parameter —

Request body

body string (required)

Body Parameter —

Responses

200

OK


post /restapi/v1/chat/xmpp

send a raw XMPP message to any destination (restapiV1ChatXmppPost)

Request body

body string (required)

Body Parameter —

Responses

200

OK


[ Jump to Methods ]

Table of Contents

  1. ArchivedMessage
  2. Bookmark
  3. Bookmarks
  4. Conversation
  5. ConversationParticipation
  6. Conversations
  7. GroupEntities
  8. GroupEntity
  9. JID
  10. MUCRoomEntities
  11. MUCRoomEntity
  12. MessageEntity
  13. MsgArchiveEntity
  14. OccupantEntities
  15. OccupantEntity
  16. ParticipantEntities
  17. ParticipantEntity
  18. RosterEntities
  19. RosterItemEntity
  20. SessionEntities
  21. SessionEntity
  22. SessionsCount
  23. SipAccount
  24. SipAccounts
  25. SystemProperties
  26. SystemProperty
  27. UserEntities
  28. UserEntity
  29. UserGroupsEntity
  30. UserProperty

body (optional)

String

conversationID (optional)

Integer

from (optional)

String

fromJID (optional)

JID

roomEvent (optional)

Boolean

sentDate (optional)

Object

stanza (optional)

String

to (optional)

String

toJID (optional)

JID

bookmarkID (optional)

Integer

globalBookmark (optional)

Boolean

groups (optional)

array[String]

name (optional)

String

properties (optional)

array[String]

property (optional)

String

propertyNames (optional)

Object

type (optional)

String

Enum:

group_chat

url

users (optional)

array[String]

value (optional)

String

bookmarks (optional)

array[Bookmark]

chatRoom (optional)

String

conversationID (optional)

Integer

conversationParticipants (optional)

array[String]

external (optional)

Boolean

lastActivity (optional)

Object

messageCount (optional)

Integer

messages (optional)

array[ArchivedMessage]

participantList (optional)

array[String]

participants (optional)

array[JID]

participations (optional)

array[ConversationParticipation]

room (optional)

JID

startDate (optional)

Object

joined (optional)

Object

left (optional)

Object

nickname (optional)

String

conversations (optional)

array[Conversation]

groups (optional)

array[GroupEntity]

admins (optional)

array[String]

description (optional)

String

members (optional)

array[String]

name (optional)

String

domain (optional)

String

node (optional)

String

resource (optional)

String

mucRooms (optional)

array[MUCRoomEntity]

adminGroups (optional)

array[String]

admins (optional)

array[String]

broadcastPresenceRoles (optional)

array[String]

canAnyoneDiscoverJID (optional)

Boolean

canChangeNickname (optional)

Boolean

canOccupantsChangeSubject (optional)

Boolean

canOccupantsInvite (optional)

Boolean

creationDate (optional)

Object

description (optional)

String

logEnabled (optional)

Boolean

loginRestrictedToNickname (optional)

Boolean

maxUsers (optional)

Integer

memberGroups (optional)

array[String]

members (optional)

array[String]

membersOnly (optional)

Boolean

moderated (optional)

Boolean

modificationDate (optional)

Object

naturalName (optional)

String

outcastGroups (optional)

array[String]

outcasts (optional)

array[String]

ownerGroups (optional)

array[String]

owners (optional)

array[String]

password (optional)

String

persistent (optional)

Boolean

publicRoom (optional)

Boolean

registrationEnabled (optional)

Boolean

roomName (optional)

String

subject (optional)

String

body (optional)

String

count (optional)

Integer

jid (optional)

String

occupants (optional)

array[OccupantEntity]

affiliation (optional)

String

jid (optional)

String

role (optional)

String

participants (optional)

array[ParticipantEntity]

affiliation (optional)

String

jid (optional)

String

role (optional)

String

roster (optional)

array[RosterItemEntity]

groups (optional)

array[String]

jid (optional)

String

nickname (optional)

String

show (optional)

String

status (optional)

String

subscriptionType (optional)

Integer

sessions (optional)

array[SessionEntity]

creationDate (optional)

Object

hostAddress (optional)

String

hostName (optional)

String

lastActionDate (optional)

Object

node (optional)

String

presenceMessage (optional)

String

presenceStatus (optional)

String

priority (optional)

Integer

ressource (optional)

String

secure (optional)

Boolean

sessionId (optional)

String

sessionStatus (optional)

String

username (optional)

String

clusterSessions (optional)

Integer

localSessions (optional)

Integer

authUsername (optional)

String

cachedSize (optional)

Integer

displayName (optional)

String

enabled (optional)

Boolean

outboundproxy (optional)

String

password (optional)

String

promptCredentials (optional)

Boolean

server (optional)

String

sipUsername (optional)

String

status (optional)

String

Enum:

Registered

Registering

RegistrationFailed

Unregistered

Unregistering

stunPort (optional)

String

stunServer (optional)

String

useStun (optional)

Boolean

username (optional)

String

voiceMailNumber (optional)

String

accounts (optional)

array[SipAccount]

properties (optional)

array[SystemProperty]

key (optional)

String

value (optional)

String

users (optional)

array[UserEntity]

email (optional)

String

name (optional)

String

password (optional)

String

properties (optional)

array[UserProperty]

show (optional)

String

status (optional)

String

username (optional)

String

groupNames (optional)

array[String]

key (optional)

String

value (optional)

String

Clone this wiki locally