HTTP Interface for Endpoints

The API /_api/endpoint is deprecated. For cluster mode there is /_api/cluster/endpoints to find all current coordinator endpoints (see below).

The ArangoDB server can listen for incoming requests on multiple endpoints.

The endpoints are normally specified either in ArangoDB's configuration file or on the command-line, using the "--server.endpoint" option. The default endpoint for ArangoDB is tcp://127.0.0.1:8529 or tcp://localhost:8529.

Please note that all endpoint management operations can only be accessed via the default database (_system) and none of the other databases.

Asking about Endpoints via HTTP

Get information about all coordinator endpoints

This API call returns information about all coordinator endpoints (cluster only).

GET /_api/cluster/endpoints

Returns an object with an attribute endpoints, which contains an array of objects, which each have the attribute endpoint, whose value is a string with the endpoint description. There is an entry for each coordinator in the cluster. This method only works on coordinators in cluster mode. In case of an error the error attribute is set to true.

Return Codes

  • 200: is returned when everything went well.
  • 403: server is not a coordinator or method was not GET.