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

Endpoint

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"}' \
     "https://api.visii.com/orgs/my-org/datasets"

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"
}