If you're new to Mesos

See the getting started page for more information about downloading, building, and deploying Mesos.

If you'd like to get involved or you're looking for support

See our community page for more details.




Brings a set of machines down.


Returns 200 OK when the operation was successful.

Returns 307 TEMPORARY_REDIRECT redirect to the leading master when current master is not the leader.

Returns 503 SERVICE_UNAVAILABLE if the leading master cannot be found.

POST: Validates the request body as JSON and transitions the list of machines into DOWN mode. Currently, only machines in DRAINING mode are allowed to be brought down.


This endpoint requires authentication iff HTTP authentication is enabled.


The current principal must be allowed to bring down all the machines in the request, otherwise the request will fail.