code: @ApiOperation(value="Schedules a job and returns the ID for the new job.",
              response=Long.class, code=201)
      @ApiResponses(value = { @ApiResponse(code = 500, message = "Unexpected error"), 
              @ApiResponse(code = 201, message = "Successfull response", examples=@Example(value= {
                      @ExampleProperty(mediaType=JSON, value=CREATE_JOB_RESPONSE_JSON)})) })
      @POST
      @Consumes({MediaType.APPLICATION_JSON, MediaType.APPLICATION_XML})
      @Produces({MediaType.APPLICATION_JSON, MediaType.APPLICATION_XML})
      public Response scheduleRequest(@javax.ws.rs.core.Context HttpHeaders headers, 
              @ApiParam(value = "optional container id that the job should be associated with", required = false) @QueryParam("containerId") String containerId, 
              @ApiParam(value = "asynchronous job definition represented as JobRequestInstance", required = true, examples=@Example(value= {
                      @ExampleProperty(mediaType=JSON, value=JOB_JSON),
                      @ExampleProperty(mediaType=XML, value=JOB_XML)})) String payload) {
          Variant v = getVariant(headers);
          String type = getContentType(headers);
          // no container id available so only used to transfer conversation id if given by client
          Header conversationIdHeader = buildConversationIdHeader("", context, headers);
  
          try {
  
              String response = executorServiceBase.scheduleRequest(containerId, payload, type);
  
              logger.debug("Returning CREATED response with content '{}'", response);
              return createResponse(response, v, Response.Status.CREATED, conversationIdHeader);
  
          } catch (IllegalArgumentException e) {
              logger.error("Invalid Command type ", e.getMessage(), e);
              return internalServerError( e.getMessage(), v, conversationIdHeader);
          } catch (Exception e) {
              logger.error("Unexpected error during processing {}", e.getMessage(), e);
              return internalServerError(errorMessage(e), v, conversationIdHeader);
          }
  
  
      }
docs: operations