# Create a dataset

Creates a new dataset for the organisation.

A note on downloading your images

We do not store/cache your images on our servers.

Every item added or updated in a dataset will be processed, meaning that the image will be downloaded from your server each time, processed and then deleted. \ Every dataset is unique, so images will be downloaded each add or update (so long as the image URL has changed), irrelevant if they are in another dataset.

# Input


POST /orgs/:organisation/datasets/:dataset

Field Type Required Value Description
organisation String yes The organisation name

# Body

Field Type Required Value Description
name String yes The name of the new dataset. Maximum length is 100 characters. Can contain letters, dashes and numbers.

# Request

curl -X POST \
     -H "Authorization: token my-org-api-token" \
     -H "Content-Type: application/json" \
     -H "Accept: application/vnd.visii.v2+json" \
     -d '{"name":"my-dataset"}' \

# Response

Field Type Value Description
status String The status of the response
dataset_url String The URL of the newly created dataset
HTTP/1.1 201 Created
  "dataset_url": "https://api.visii.com/orgs/my-org/datasets/my-dataset",
  "status": "ok"
Last Updated: 12/20/2021, 12:19:51 PM