HTTP Codes

These HTTP codes are returned for all of the IBM® Connect:Direct Web Services RESTful APIs in response

Table 1. HTTP return codes
HTTP code Description
HTTP/1.1 200 OK "OK" success code for requests other than creations and deletions
HTTP/1.1 201 OK "Created" success code for POST request
HTTP/1.1 500 Internal Server Error The request failed due to internal error (Internal Server Error)
HTTP/1.1 404 Not Found The requested resource couldn't be found.
HTTP/1.1 401 Unauthorized (Unauthorized) The session ID or access token used has expired or is invalid. The response body contains the message and errorCode. The user must be logged in to make this API request. Check the value of the Authorization HTTP request header
HTTP/1.1 503 Service Unavailable Service unavailable(A backend error occurred)
HTTP/1.1 400 Bad Request The request couldn’t be understood, usually because the JSON body contains an error. The API request is invalid or improperly formed. Consequently, the API server could not understand the request
HTTP/1.1 403 Forbidden The request has been refused. Verify that the logged-in user has appropriate permissions. If the request syntax is correct, but the server is not able to find the item it. The requested operation is forbidden and cannot be completed