DELETE/orgs/:org/datasets/:dataset/content

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

URL

Field Type Required Value Description
org string yes

The organisation name.

dataset string yes

The dataset name.

Body

Field Type Required Value Description
content array of objects 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 255 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 Required Value Description
status string yes

The status of the response.

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