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 an asset based on the passed id

DELETEhttps://__tenant__.dscribedata.com/api/assets/{id}

Authorization

BearerAuth

Path parameters

id*string

Response

204404500

Successful operation

Request

JavaScriptCurlPython

const response = await fetch('https://__tenant__.dscribedata.com/api/assets/{id}', {
    method: 'DELETE',
    headers: {
      "Authorization": "Bearer <token>"
    },
});
const data = await response.json();

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 one or more assets

DELETEhttps://__tenant__.dscribedata.com/api/assets

Authorization

BearerAuth

Body

application/json

A list of asset ids to be deleted.

itemsstring

Response

200400500

Successful operation

Request

JavaScriptCurlPython

const response = await fetch('https://__tenant__.dscribedata.com/api/assets', {
    method: 'DELETE',
    headers: {
      "Authorization": "Bearer <token>",
      "Content-Type": "application/json"
    },
    body: JSON.stringify([
      "text"
    ]),
});
const data = await response.json();

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"],
  }),
});