When REST API requests are sent to carryout various actions, various HTTP status codes will be returned based on the state of the action (success or failure) and the HTTP method (POST, GET, PUT, DELETE) executed. The following are the definitions of the various HTTP status codes that are returned:

Success HTTP status codes


The server has received the request headers, and the client should proceed to send the request body. This is applicable in the case of a request for which a body needs to be sent (e.g., POST request). This interim response is used to inform the client that the initial part of the request has been received and has not yet been rejected by the server. The server will send a final response after the request has been completed.

200OkHTTP request was successful. The output corresponding to the HTTP request will be returned. Generally used as a response to a successful GET and PUT REST API HTTP methods.
201CreatedHTTP request was successfully processed and a new resource was created. Generally used as a response to a successful POST REST API HTTP method.
202AcceptedHTTP request was accepted for processing, but the processing has not been completed. This generally occurs when your successful in trying to deploy or undeploy an application.

Error HTTP status codes

CodeCode SummaryDescription
400Bad requestThe server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid JSON format).
403ForbiddenThe request was a valid request, but the server is refusing to respond to it. This status code appears when executing a metadata service REST API with an incorrect token.
404Not foundRequested resource not found. Generally used as a response for unsuccessful GET and PUT REST API HTTP methods. This code will also be returned when trying to delete (DELETE) an artifact that does not exist.
409ConflictRequest could not be processed because of conflict in the request. This generally occurs when you are trying to add a resource that already exists. For example, when trying to add an auto-scaling policy that has an already existing ID.
500Internal server errorServer error occurred.
  • No labels