Deleting Assets

You can delete one or multiple assets via the following requests.

If you delete a dataset that has DSEs linked to it, those DSEs will be removed as well.

If you do not want to delete an asset but still want to hide it for users while you are still working on the documentation, you can take a look at discovery policies in combination withAutomations.

Delete one asset

Delete on asset

delete

Delete an asset based on the passed id

Authorizations

Path parameters

idstringRequired

Responses

204

Successful operation

404

Asset not found

500

Internal server error

delete

HTTPcURLJavaScriptPython

DELETE /api/assets/{id} HTTP/1.1
Host: __tenant__.dscribedata.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

const url = "https://{your_tenant}.dscribedata.com/api/assets/:id";
const authToken = "yholmghj8§hbfg...";

fetch(url, {
  method: "DELETE",
  headers: {
    Authorization: `Bearer ${authToken}`,
    "Content-Type": "application/json",
  },
});

Deleting multiple assets

Delete multiple assets

delete

Delete one or more assets

Authorizations

Body

string[]Optional

Responses

200

Successful operation

400

One of the values passed to the API is wrong

500

Internal server error

delete

HTTPcURLJavaScriptPython

DELETE /api/assets HTTP/1.1
Host: __tenant__.dscribedata.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 8

[
  "text"
]

No content

const url = "https://{your_tenant}.dscribedata.com/api/assets";
const authToken = "yholmghj8§hbfg...";

fetch(url, {
  method: "DELETE",
  headers: {
    Authorization: `Bearer ${authToken}`,
    "Content-Type": "application/json",
  },
  body: JSON.striningify({
    ids: ["123", "456"],
  }),
});