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.




Reserve resources dynamically on a specific agent.


Returns 202 ACCEPTED which indicates that the reserve operation has been validated successfully by the master.

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.

The request is then forwarded asynchronously to the Mesos agent where the reserved resources are located. That asynchronous message may not be delivered or reserving resources at the agent might fail.

Please provide “slaveId” and “resources” values describing the resources to be reserved.


This endpoint requires authentication iff HTTP authentication is enabled.


Using this endpoint to reserve resources requires that the current principal is authorized to reserve resources for the specific role. See the authorization documentation for details.