HTTP Return Codes

This page describes the UnifiedAPI HTTP return codes.

Format

UnifiedAPI returns errors using a JSON format:

{
"error": {
    "code":"access_denided",
    "message":"You are not authorized to use this request."
    }
}

The following successful return codes are common to all requests:

HTTP Code	Description
200	The object of the request is returned.
204	There is no object to be returned.

The following error can occur in all requests:

HTTP Code	Code	Description
501	request_not_implemented	You are not allowed to make the request because the operation is not implemented.
400	user_invalid	Value supplied in the URI-Fragment as userId is invalid. The parameter must reference the Id of an user or can be set to @owner, @me or @viewer.
401	access_denied	You are not authorized to use this request.
400	extension_invalid	Value supplied in the URI-Fragment as extension is invalid. The parameter must reference the number of an existing extension or can be set to @self.
500	internal_server_error	An internal server error occurred. Please contact the administrator.