# 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 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 Value Description
status String The status of the response
HTTP/1.1 200 OK
{
  "status": "ok"
}
Last Updated: 2/7/2020, 11:17:32 AM