Skip to content

Delete a user-authored view from the caller's world

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

The name of a view the caller saved, as GET /kg/studio/views lists it; a shipped or realm view is not the caller’s to remove and, like an unknown name, is a 404

View deleted

Media typeapplication/json

A user-authored view was deleted.

object
name
required

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

string
status
required

Always deleted.

string

Example generated

{
"name": "example",
"status": "example"
}

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"
}

No saved view of that name

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"
}