Skip to content

Force-recompute a materialised view's cache now, ignoring its TTL

POST
/api/v1/kg/studio/views/{name}/refresh
curl --request POST \
--url http://localhost:11044/api/v1/kg/studio/views/example/refresh \
--header 'X-Embabel-Api-Key: <X-Embabel-Api-Key>'
name
required
string

The materialised view’s name, as GET /kg/studio/views lists it; a regular or unknown view is not an error and answers refreshed: false

Whether anything was recomputed

Media typeapplication/json

Whether a materialised view’s cache was recomputed.

object
name
required

The view’s name, as given in the path.

string
refreshed
required

False for a regular or unknown view — nothing was recomputed.

boolean

Example generated

{
"name": "example",
"refreshed": true
}

Not authenticated

Media typeapplication/json

A refusal carrying only a human-readable reason.

object
error
required

What went wrong, in the terms the caller can act on.

string

Example generated

{
"error": "example"
}