Skip Navigation
  1. BlackBerry Docs
  2. BlackBerry Enterprise Mobility Server 3.8
  3. BlackBerry Connect messaging APIs
  4. HTTP response codes

HTTP response codes

JSONRPC errors 

Code
Text Code
Description
-32700
PARSE_ERROR
An error occurred on the 
BEMS-Connect
 service while parsing the JSON text. 
-32600
INVALID_REQUEST
The received JSON is not a valid JSON-RPC message.
-32601
METHOD_NOT_FOUND
The requested remote procedure doesn't exist or is not available.
-32602
INVALID_PARAMS
The method parameters are invalid.

BEMS-Connect
 errors (Generic)

Code
Text Code
Description
1004
PARSE_ERROR
The 
BEMS-Connect
 service can't create the chat session. 
1005
GENERAL_FAILURE
The 
BEMS-Connect
 service encountered a fatal error serving the request.
1006
GPS_NOT_RESPONDING
The 
BlackBerry Proxy
 is not responding.
1007
INVALID_GD_TOKEN
The 
BEMS-Connect
 service can't verify the GD token.
1008
INVALID_GD_AUTHTOKEN
The 
BEMS-Connect
 service could not verify the GD authtoken.
1009
GPS_HTTP_ERROR
An error response is received from the 
BlackBerry Proxy
. 
1011
NULL_ARGUMENT
One or more parameters are of a null value or empty. 
1012
INVALID_ARGUMENT
One or more arguments are not valid.
1013
INVALID_OPERATION
An invalid operation occurred.
1017
CLIENT_SESSION_TIMEOUT
The 
BlackBerry Connect
 client session has timed out.
1018
OPERATION_FAILURE
The operation failed due to an invalid object state.
1019
RT_EXCEPTION
The operation failed due to SIP-related errors.
1020
PUBLISH_SUBSCRIBE_EXCPT
The SIP Service request was rejected by the instant messaging server.
1021
DEPENDENT_REQUEST_FAILED
A dependent request failed in this batch.
1023
SELF_REFERENCE_DEPENDENCY
The request makes a self referential dependency.
1024
UNKNOWN_BATCH_DEPENDENCY
The request dependency reference is unknown or undefined.
1025
ACTION_PENDING
The request is currently in progress.
1026
NOT_SUPPORTED_BY_SERVER
The request by the 
BlackBerry Connect
 client is not supported by this 
BEMS-Connect
 service version.
1027
WRONG_SERVER
The 
BlackBerry Connect
 client should connect to a different 
BEMS-Connect
 service.
1028
SERVER_BUSY
The server is too busy.

SendMessage 

Code
Text Code
Description
4000
MSG_INVALID_OPERATION
The method is invoked multiple times using the same asyncResult.
4001
MSG_OPERATION_FAILURE
The operation failed due to invalid object state.
4002
REAL_TIME_FAILURE
The operation failed due to SIP-related errors.
4003
MSG_REMOTE_FAILURE_RESPONSE
The recipient contact doesn't respond to the establish request operation. 
4004
MSG_DND_FAILURE
The message is not sent because the recipient has a Do Not Disturb state specified.
4005
MSG_NOT_FEDERATED_OR_INVALID_user 
The contact is outside of your organization and is not federated with your company, or the user is invalid.
4006
INVITATION_FAILURE_RESPONSE
The recipient contact declined your invitation.  

Accept Chats

Code
Text Code
Description
7000
INVALID_REQUESTID
An invitation is not available for the request ID.
7001
ACCEPT_CHAT_RT
The user is unable to complete accepting chat. 
7002
AC_INVALID_PARAMS
BEMS-Connect
 service cannot accept the call because of invalid parameters. 
7003
AC_INVALID_OPERATION
BEMS-Connect
 service cannot accept the call because of an invalid operation.
4005
MSG_NOT_FEDERATED_OR_INVALID
_USER
The user is outside of your organization and is not federated with your company, or the user is incorrect.
4006
INVITATION_FAILURE_RESPONSE
The recipient contact declined your invitation.  

BeginSession 

Code
Text Code
Description
10000
REGISTRATION_ERROR
An invitation is not available for the request ID.
10001
AUTHENTICATION_ERROR
The user is unable to complete accepting the chat request. 

TerminateSession

Code
Text Code
Description
11000
SESSION_NOT_FOUND
The 
BEMS-Connect
 service couldn't find the session ID. Have the user log in to 
BlackBerry Connect
 again.
11001
XML_EXCEPTION
The 
BEMS-Connect
 service encountered a XML exception.

AddContact

Code
Text Code
Description
12000
ADD_CONTACT_FAILURE
Failed to add the contact to the 
BlackBerry Connect
 client contact list.  
12001
ADD_CONTACT_EXISTS
The contact already exists in the 
BlackBerry Connect
 client contact list.

RemoveContact

Code
Text Code
Description
13000
REMOVE_CONTACT_FAILURE
Contact does not exist in the 
BlackBerry Connect
 client. 

BlockContact

Code
Text Code
Description
14001
BLOCK_ALREADY_FAILURE
User is already blocked in the 
BlackBerry Connect
 client. 

UnblockContact

Code
Text Code
Description
15000
UNBLOCK_CONTACT_FAILURE
Failed to unblock user.
15001
UNBLOCK_ALREADY_FAILURE
The user is already unblocked. 

Active Directory

Code
Text Code
Description
26000
ADCACHE_EXCEPTION
Failed to setup ActiveDirectoryCache.
26001
ADCACHE_SIP_NOT_FOUND_EXCEPTION
Failed to find the SIP address of the contact.
26002
ADCACHE_MULTIPLE_SIP_EXCEPTION
The user has multiple SIP addresses.
26003
ADCACHE_INVALID_USER_EXCEPTION
The user is invalid.

RegisterTempRemotePresence

Code
Text Code
Description
27000
REGISTER_TEMP_REMOTE_PRESENCE_EXCEPTION
Failed to setup RegisterTempRemotePresence.
27001
REGISTER_TEMP_REMOTE_PRESENCE_ALREADY_EXISTS
The user already exists in the Contact List.

UnregisterTempRemotePresence

Code
Text Code
Description
28000
UNREGISTER_TEMP_REMOTE
_PRESENCE_EXCEPTION
Failed to setup RegisterTempRemotePresence.
28001
UNREGISTER_TEMP_REMOTE_
_PRESENCE_USER_NOT_IN_CONTACTLIST
_CONTACTLIST_EXCEPTION
The user is not in the 
BlackBerry Connect
 contact list.
28002
UNREGISTER_TEMP_REMOTE
_PRESENCE_BAD_TYPE_EXCEPTION
The user has the wrong type (for example, the userID is an object type instead of a string type). 

NotifyBackground

Code
Text Code
Description
29001
NOTIFYBACKGROUND_
ALREADY_IN_MODE
The 
BlackBerry Connect
 app is already in the background.  

StartChat

Code
Text Code
Description
31031
CHAT_DOES_NOT_EXIST
There is no existing chat conversation with the specified recipient contact.  
31032
WRONG_CHAT_ID
The existing chat conversation with the specified recipient contact has a different chat ID. 
31033
CONTACT_OFFLINE
The specified contact is not logged in.
31034
NOT_CONTACT
The specified user is not on the contact list.

Persistent chat

Code
Text Code
Description
40000
PC_INVALID_OPERATION
The endpoint is not in a valid state. An endpoint can only be established once and cannot be reused after being terminated.
40001
PC_NULL_ARGUMENT
The asyncResult parameter is a null value. 
40002
PC_COMMAND_FAILURE
The endpoint is not in a valid state to be established or the connection call flow is interrupted.
40003
PC_SERVER_CONNECTION_FAILURE
The PersistentChatEndpoint is not established, or the instant messaging server is not reachable, or the connection attempt is refused instant messaging server.
40004
PC_INVALID_PARAMS
The method includes invalid parameters.
40005
PC_GENERAL_FAILURE
The 
BEMS-Connect
 service encountered a fatal error serving the persistent chat request.
40019
PC_RT_EXCEPTION
The session encountered an error communicating with the instant messaging server.
40020
PC_SESSION_INVALID
The session is in an invalid state. The State cannot be idle. 
40021
PC_INVALID_ARGUMENT
The input parameters are invalid.
40025
PC_MESSAGE_TOO_LONG
The message is too long.
40100
PC_NOT_SUPPORT_FAILURE
The persistent chat service is not enabled for this user or instant messaging server.
40101
PC_ROOM_STATE_FAILURE
Group discussion is in an invalid state or the user did not join yet. 
40102
PC_ACCESS_DENIED
The signed in user is not authorized to perform the action. 
40103
PC_DUPLICATE_ROOM_NAME
A group discussion or category with that name already exists.
40104
PC_ROOM_DISABLED
The group discussion is disabled.
40105
PC_ROOM_NOT_EXIST
The group discussion does not exist.
40106
PC_ROOM_NAME_TOO_LONG
The group discussion name is longer than 256 characters, spaces included. 
40107
PC_ROOM_HIERARCHY_FAILURE
User cannot create rooms under the root category.
40109
PC_CONNECTION_INTERRUPTED
Connection flow interrupted. The endpoint is in an invalid state for the attempted operation.
40110
PC_DATABASE_CONNECTION_FAILURE
There was a problem with the 
BEMS-Connect
 service connection to the 
Microsoft SQL Server
 database.
40111
PC_DATA_COLLISION_FAILURE
The object being modified has been changed. Refresh your copy of the object before attempting to modify it.
40112
PC_DUPLICATE_ADDIN_NAME
There is an existing addin name.
40113
PC_FILE_DOWNLOAD_FAILURE
BEMS
 failed to download the file. 
40114
PC_FILE_UPLOAD_FAILURE
BEMS
 failed to upload the file. 
40115
PC_INVALID_COMMAND_ARGUMENT
One or more provided parameters to the command are invalid.
40116
PC_INVALID_FILE_TRANSFER_TOKEN
Chat server (Lync/S4B) returned an invalid file transfer security token.
40117
PC_LIMIT_EXCEEDED
You have exceeded an internal server limit. 
40118
PC_MESSAGE_NOT_SUPPORTED
The command is not supported by the 
BEMS-Connect
 service.  
40119
PC_NO_SUCH_PRINCIPAL_FAILURE
One or more principals are invalid.
40122
PC_PRINCIPALS_ALREADY_DEFINED
The principals are already defined.
40123
PC_PRINCIPALS_NOT_IN_SCOPE
The principals are not in scope.
40124
PC_SERVER_ERROR
The instant messaging server reported an error. Refer to the exception message for the error code.  
40125
PC_CREATE_ROOM_FAILURE
The signed in user cannot create the group discussion.
40126
PC_UNKNOWN_SERVER_FAILURE
An unknown error occurred on the server.
40127
PC_USER_NOT_JOINED_FAILURE
The signed in user has not joined to the group discussion.
40128
PC_PARTICIPANT_LIST_FAILURE
The user can't request the participant list of the group discussion.
40129
PC_DUPLICATE_ROOM_NAME_UPDATE_
UNKNOWN_SERVER_ERROR
An unknown error occurred on the 
Connect
 service. Updating the group discussion name with an existing room name may cause this error.
40130
PC_SAME_FILE_UPLOAD_NOT_ALLOWED
The file that is being uploaded to the specified group discussion is a duplicate. Duplicate uploads are not allowed.
40131
PC_FILE_POST_NOT_ALLOWED
File post operations are not allowed for the specified group discussion under category settings.