Errors

The service will respond with a 4xx or 5xx status code if an error is encountered. The JSON body will provide additional details.

HTTP/1.1 502 Bad Gateway
Content-Type: application/json

{
    "errorCode": 1780355652,
    "errorDetails": {
        "causes": [ "HTTP 401 Unauthorized" ],
        "command": "Invitation",
        "listenerServiceId": "123",
        "remoteAddress": "1.2.3.4",
        "remoteId": "abc",
        "remoteName": "My Endpoint",
        "remoteRequest": "GET http://1.2.3.4/ HTTP/1.1\nAuthorization: Basic [redacted]",
        "remoteResponse": "HTTP/1.1 401 Unauthorized"
    },
    "errorMessage": "Authentication failed from My Endpoint (1.2.3.4); it is probably provisioned incorrectly.",
    "errorName": "AuthenticationFailed"
}

Error catalog

AuthenticationFailed

Example errorMessage: Authentication failed from My Endpoint (1.2.3.4); it is probably provisioned incorrectly.
Keys in errorDetails object: causes, remoteResponse, listenerServiceId, remoteAddress, remoteRequest, command, remoteId, remoteName

502 1780355652

BadCommand

Example errorMessage: Listener Service could not parse the command; upgrade it to the latest version.
Keys in errorDetails object: commandName, causes, listenerServiceId

500 47328961

BadCredentialsException

Example errorMessage: Not Authorized.
Keys in errorDetails object: errorMessage, errorCode

401 1285563821

CalendarServerException

Example errorMessage: Unable to retrieve details from calendar server for ID [unknown]: java.lang.RuntimeException (null)
Keys in errorDetails object: calendarId, message

502 187263818

CommandTimedOut

Example errorMessage: Request timed out to Listener Service; it may be offline or an old version.
Keys in errorDetails object: commandName, causes, listenerServiceId

504 1331991805

DuplicateCalendarId

Example errorMessage: Duplicate calendarID!
Keys in errorDetails object: message, causeMessage

400 1782937294

EncryptionUpdated

Example errorMessage: Public key for endpoint password encryption has been updated, deleted, or added. Re-enter Password!
Keys in errorDetails object: message

500 1065375345

EndpointHasNoListenerService

Example errorMessage: No Listener Service provisioned for My Endpoint; choose a Listener Service for this endpoint.
Keys in errorDetails object: commandName, endpointName, listenerServiceId

500 1881171133

ExternalSystemException

Example errorMessage: Unable to communicate with My Endpoint (1.2.3.4); make sure it is online and correctly provisioned. Listener Service was unable to communicate with an external system
Keys in errorDetails object: commandName, causes, message, remoteAddress, remoteId, remoteName

500 837158652

ExternalSystemResponseException

Example errorMessage: My Endpoint (1.2.3.4) responded with an error.
Keys in errorDetails object: commandName, causes, remoteResponse, remoteAddress, remoteRequest, remoteId, remoteName

500 1417554097

ExternalSystemTimedOut

Example errorMessage: Request timed out to My Endpoint (1.2.3.4); it might have gone offline or been provisioned incorrectly.
Keys in errorDetails object: causes, listenerServiceId, remoteAddress, command, remoteId, remoteName

504 594923066

ExternalSystemUnreachable

Example errorMessage: Unable to reach My Endpoint (1.2.3.4); it might have gone offline or been provisioned incorrectly.
Keys in errorDetails object: causes, listenerServiceId, remoteAddress, command, remoteId, remoteName

504 1436062998

ForwardsCompatibility

Example errorMessage: Listener Service is out of date; upgrade it from 2.0.0 to the latest version.
Keys in errorDetails object: listenerServiceVersion, commandName, listenerServiceId

501 2123224504

IncorrectlyProvisioned

Example errorMessage: My Endpoint (1.2.3.4) is not provisioned correctly: 404 Not Found
Keys in errorDetails object: causes, message, remoteResponse, listenerServiceId, remoteAddress, remoteRequest, command, remoteId, remoteName

502 1917844536

Invalid

Example errorMessage: An entity was invalid: Wharrrgarbl cannot be null!
Keys in errorDetails object: message, causeMessage

400 1782937293

InvalidDtmf

Example errorMessage: Must be valid
Keys in errorDetails object: message, causeMessage

400 1782937295

InvalidListSize

Example errorMessage: Must be valid
Keys in errorDetails object: message, causeMessage

403 1782937296

JsonMappingException

Example errorMessage: Malformed JSON body
Keys in errorDetails object: pathReference, message

500 12789219

JsonParseException

Example errorMessage: Malformed JSON bodynull

500 12789218

LimitReached

Example errorMessage: Endpoint limit reached. Please contact BlueJeans support to increase the limit.
Keys in errorDetails object: entityClass

403 1881171140

ListenerOffline

Example errorMessage: The Listener Service is offline.
Keys in errorDetails object: listenerServiceId

503 208581637

ListenerServiceException

Example errorMessage: The Listener Service failed trying to handle the Invitation command.
Keys in errorDetails object: commandName, causes, listenerServiceId

500 1296998295

MessagingException

Example errorMessage: Unable to communicate with Listener Service; it may be offline or an old version.
Keys in errorDetails object: commandName, causes, listenerServiceId

502 72013363

NoSuchHandler

Example errorMessage: Listener Service is out of date; upgrade it from 2.0.0 to the latest version.
Keys in errorDetails object: listenerServiceVersion, commandName, listenerServiceId

501 424016482

NotAuthenticated

Example errorMessage: NotAuthenticated Exception.
Keys in errorDetails object: errorMessage, errorCode

401 1285563822

NotFound

Example errorMessage: No Endpoint found with the given id 123.
Keys in errorDetails object: entityClass, entityId

404 1217481661

PrimetimeApiException

Example errorMessage: Problem communicating with Primetime. Please try again soon.null

500 123834739

PrimetimeEventNotStarted

Example errorMessage: The Primetime meeting has not yet started.null

405 748396429

PrimetimeNotAuthorized

Example errorMessage: The Primetime meeting is not open to the public.null

403 598238723

PrimetimeNotFound

Example errorMessage: The Primetime meeting was not found.null

404 38393928

RecordingAuthException

Example errorMessage: Not allowed to start recording meeting 10990, try using the moderator passcode.
Keys in errorDetails object: action, meetingId, seamResponseCode

502 502203690

RecordingException

Example errorMessage: Unable to start recording meeting 10990 due to 500 response from Seam.
Keys in errorDetails object: action, meetingId, seamResponseCode

502 1843016393

RecordingProhibited

Example errorMessage: Recording is disabled for meeting 10990.
Keys in errorDetails object: action, meetingId, seamResponseCode

405 1143094451

RecordingQuotaExceeded

Example errorMessage: Unable to start recording meeting 10990 due to recording quota exceeded
Keys in errorDetails object: action, meetingId, seamResponseCode

502 1843016394

RemoteCommandException

Example errorMessage: The remote system failed trying to handle the command.null

500 1296998294

Unavailable

Example errorMessage: Server error response from My Endpoint (1.2.3.4); it might have crashed or been provisioned incorrectly.
Keys in errorDetails object: causes, remoteResponse, listenerServiceId, remoteAddress, remoteRequest, command, remoteId, remoteName

503 2042734031

UnknownControlProtocol

Example errorMessage: Listener Service is out of date; upgrade it from 2.0.0 to the latest version.
Keys in errorDetails object: listenerServiceVersion, commandName, listenerServiceId

501 941644305

Unmodifiable

Example errorMessage: Cannot modify DialStyle ANNEX_O.
Keys in errorDetails object: entityClass, entityId

405 1867716210