Skip to content

List installed realms

GET
/api/v1/realms
curl --request GET \
--url http://localhost:11044/api/v1/realms \
--header 'X-Embabel-Api-Key: <X-Embabel-Api-Key>'

Returns all realms installed in the world — the shipped Realms view’s rows, filtered to installed, so this listing and a MATCH (r:Realm) query can never disagree.

List of realms

Media type*/*
Array<object>
object
key
additional properties

The Realms view is unavailable, or the engine read failed. Deliberately not an empty list: a failed read must never present as no realms installed

Media type*/*

The body the servlet error dispatch answers for a status raised by an exception rather than written by the endpoint. Every failure except 404, which answers the not-found HTML page

object
error
required

The status’s standard reason phrase, such as Bad Request or Forbidden

string
path
required

The request path that failed

string
status
required

The HTTP status code, repeated from the status line

integer format: int32