post

Signature

def post: Directive0

Description

Matches requests with HTTP method POST.

This directive filters the incoming request by its HTTP method. Only requests with method POST are passed on to the inner route. All others are rejected with a MethodRejection, which is translated into a 405 Method Not Allowed response by the default RejectionHandler.

Example

val route = post { complete("This is a POST request.") }

// tests:
Post("/", "post content") ~> route ~> check {
  responseAs[String] shouldEqual "This is a POST request."
}
The source code for this page can be found here.