Refresh the world's realms

POST

/api/v1/realms/refresh

const url = 'http://localhost:11044/api/v1/realms/refresh';
const options = {method: 'POST', headers: {'X-Embabel-Api-Key': '<X-Embabel-Api-Key>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

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

Rebuilds the caller’s world so realm references added or removed since the last build take effect — the runtime-install step for a realm referenced by local path, which nothing clones and no per-realm update can see before it is loaded.

Authorizations

apiKeyAuth
basicAuth

Responses

200

World rebuilt; response lists the realms now loaded

*/*

The world was rebuilt, and these realms are loaded now

object

realms

required

The names of the realms loaded after the rebuild

Array<string>

status

required

Always refreshed

string

Allowed values: refreshed