Evict the directory caches so the next browse re-scans the sources

POST

/api/v1/directory/refresh

const url = 'http://localhost:11044/api/v1/directory/refresh?type=SKILL';
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/directory/refresh?type=SKILL' \
  --header 'X-Embabel-Api-Key: <X-Embabel-Api-Key>'

The GitHub realm scan is cached for the life of the process; this evicts it — the way a newly published realm becomes visible without a restart. Optionally scoped by type.

Authorizations

apiKeyAuth
basicAuth

Parameters

Query Parameters

type

string

Allowed values: SKILL API MCP_SERVER REALM

Only refresh directories of this type

Responses

200

Caches evicted; the next browse re-fetches from the sources

*/*

Acknowledgement from POST /directory/refresh that the directory caches were evicted

object

refreshed

required

Always true; eviction is best-effort per source and a failing source does not fail the request

boolean