An operation response is a possible response a client can expect when invoking an operation in the REST API descriptor. When you add a REST resource to a REST API descriptor, Designer creates two responses for each operation in the REST resources:

You can add or delete operation responses. For example, you might want to have a response for successful execution of an operation and a separate response for each known error the operation can return. Designer requires that an operation have at least one response. If an operation has only one response, it is a best practice to make sure that the response is for successful execution of the operation.

When an operation returns output, the returned output needs to have some explanation, such as the returned parameters. In general, Integration Server derives the output from the output signature of a service corresponding to the REST operation. If a service has output parameters, Integration Server generates a REST definition that corresponds to the output signature.

When an operation returns output with the response and the operation has output parameters, the HTTP status code includes a hyperlink. When clicked, Designer opens the REST Definitions tab and displays the response document for the operation.