Delete content from a dataset

Delete content associated with a dataset. The API allows specifying multiple IDs in the same request. IDs that are not found in the dataset are ignored and do not generate error responses.

The deleted content will not be disappear straight away from the Vision API. It usually takes up to a few minutes until all systems are aware of the content change.

Input

Endpoint

DELETE /orgs/:organisation/datasets/:dataset/content

Field	Type	Required	Value Description
organisation	String	yes	The organisation name
dataset	String	yes	The dataset name

Body

Field	Type	Required	Value Description
content	Object	yes	The content to remove from the dataset. Maximum length is 1000 objects.
content.$.id	String	yes	The unique ID for the content. Maximum length is 100 characters.

Example

{
  "content": [
    {
      "id": "my-id-1"
    },
    {
      "id": "my-id-2"
    },
    {
      "id": "my-id-3"
    }
  ]
}

Request

curl -X DELETE \
     -H "Authorization: token my-org-api-token" \
     -H "Content-Type: application/json" \
     -H "Accept: application/vnd.visii.v2+json" \
     -d '{"content":[{"id":"123"},{"id":"234"}]}' \
     "https://api.visii.com/orgs/my-org/datasets/my-dataset/content"

Response

Field	Type	Value Description
status	String	The status of the response

HTTP/1.1 200 OK
{
  "status": "ok"
}