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.




Information about roles.


Returns 200 OK when information about roles was queried successfully.

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.

This endpoint provides information about roles as a JSON object. It returns information about every role that is on the role whitelist (if enabled), has one or more registered frameworks, or has a non-default weight or quota. For each role, it returns the weight, total allocated resources, and registered frameworks.


This endpoint requires authentication iff HTTP authentication is enabled.