# Get dataset details

Gets the details for a dataset.

# Input

Endpoint

GET /orgs/:organisation/datasets/:dataset

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

# Request

curl -X GET \
     -H "Authorization: token my-org-api-token" \
     -H "Accept: application/vnd.visii.v2+json" \
     "https://api.visii.com/orgs/my-org/datasets/my-dataset"

# Response

Field Type Value Description
status String The status of the response
dataset Object The details of the dataset
dataset.browse_token String The authorization token needed when accessing this dataset via the Vision API.
This token is different from Organisation Token to allow client-side requests with a read-only token.
dataset.content_url String The URL for the content of the dataset. This is used to add new content.
dataset.name String The dataset name
dataset.processing_errors_url String The URL for the outstanding processing errors
dataset.settings Object The dataset settings
dataset.settings.fields Object The list of array fields and values enabled for querying. For more information check fields page
dataset.status String The current status of the dataset. Possible values are pending and published.
HTTP/1.1 200 OK
{
  "dataset": {
    "browse_token": "abcdefghijklmnopqrstuvwxyz123456789",
    "content_url": "https://api.visii.com/my-org/datasets/my-dataset/content",
    "name": "my-dataset",
    "processing_errors_url": "https://api.visii.com/orgs/my-org/datasets/my-dataset/errors",
    "settings": {
      "fields": {
        "arrayField": ["specific", "values", "to", "enable"],
        "arrayNumField": ["*"]
      },
      "version":1
    },
    "status": "published"
  },
  "status": "ok"
}
Last Updated: 6/30/2022, 12:24:16 PM