title: How can I set Swagger to ignore @Suspended AsyncResponse in @Asynchronous jax-rs bean methods?
body: <p>Swagger-Core seems to interpret the @Suspended final AsyncResponse asyncResponse member as request body param. This is clearly not intended nor the case.</p>
  
  <p>I would like to tell swagger-core to ignore this parameter and to exclude it from the api-docs. Any ideas?</p>
  
  <p>This is what my code looks like:</p>
  
  <pre><code>@Stateless
  @Path("/coffee")
  @Api(value = "/coffee", description = "The coffee service.")
  public class CoffeeService
  {
      @Inject
      Event&lt;CoffeeRequest&gt; coffeeRequestListeners;
  
      @GET
      @ApiOperation(value = "Get Coffee.", notes = "Get tasty coffee.")
      @ApiResponses({
              @ApiResponse(code = 200, message = "OK"),
              @ApiResponse(code = 404, message = "Beans not found."),
              @ApiResponse(code = 500, message = "Something exceptional happend.")})
      @Produces("application/json")
      @Asynchronous
      public void makeCoffee( @Suspended final AsyncResponse asyncResponse,
  
                               @ApiParam(value = "The coffee type.", required = true)
                               @QueryParam("type")
                               String type)
      {
          coffeeRequestListeners.fire(new CoffeeRequest(type, asyncResponse));
      }
  }
  </code></pre>
  
  <hr>
  
  <h3>Update: Solution based on Answer</h3>
  
  <pre><code>public class InternalSwaggerFilter implements SwaggerSpecFilter
  {
      @Override
      public boolean isOperationAllowed(Operation operation, ApiDescription apiDescription, Map&lt;String, List&lt;String&gt;&gt; stringListMap, Map&lt;String, String&gt; stringStringMap, Map&lt;String, List&lt;String&gt;&gt; stringListMap2) {
          return true;
      }
  
      @Override
      public boolean isParamAllowed(Parameter parameter, Operation operation, ApiDescription apiDescription, Map&lt;String, List&lt;String&gt;&gt; stringListMap, Map&lt;String, String&gt; stringStringMap, Map&lt;String, List&lt;String&gt;&gt; stringListMap2) {
          if( parameter.paramAccess().isDefined() &amp;&amp; parameter.paramAccess().get().equals("internal") )
              return false;
          return true;
      }
  }
  </code></pre>
  
  <hr>
  
  <pre><code>FilterFactory.setFilter(new InternalSwaggerFilter());
  </code></pre>
  
  <hr>
  
  <h3>Revised Example Code Fragment</h3>
  
  <pre><code>...
  @Asynchronous
  public void makeCoffee( @Suspended @ApiParam(access = "internal") final AsyncResponse asyncResponse,...)
  ...
  </code></pre>