dataset

List Dataset

get/policies/dataset

Query parameters

limitinteger

Size of the subset to retrieve.

offsetinteger

Number of items to skip during retrieval.

namestring

Name filter. Filtering is performed as a case-insensitive partial match.

order'name' | 'id'

Order type.

dir'asc' | 'desc'

Order direction.

tagsobject

Tags filter. Filtering is performed as a case-insensitive partial key value match.

Response

Data retrieved.

totalinteger

Total number of items

offsetinteger

Number of items to skip during retrieval

limitinteger

Maximum number of items to return in one page

Example response

{
  "dataset": [
    {
      "name": "my-dataset",
      "tags": {
        "region": "eu",
        "node_type": "dns"
      }
    }
  ]
}

Changes

Changed in 8 of the 25 revisions of this API.613

Jul 17, 2026d95ee7691efb1See the full diff
- ▲
  added the new required header request parameter Authorization to all path's operations
  new-required-request-default-parameter-to-existing-path
Oct 4, 2022ce59b3bdec001See the full diff
- ▲
  added the new required header request parameter Bearer authorization to all path's operations
  new-required-request-default-parameter-to-existing-path
Sep 27, 20225085d5b16a492See the full diff
- ▲
  for the query request parameter tags, default value {"key":"value"} was removed
  request-parameter-default-value-removed
- ▲
  for the query request parameter tags, the type changed from string to object
  request-parameter-type-changed
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
May 6, 20229309037e46b911See the full diff
- ●
  removed the optional property // from the response with the status
  response-optional-property-removed
- ○
  added the optional property // to the response with the status
  response-optional-property-added
Sep 22, 2021dc9b53b51fdd1See the full diff
- ▲
  the // response's property type changed from string to array, and format from uuid to no format for status
  response-property-type-changed
Aug 31, 2021adfab293130f1See the full diff
- ○
  added the new optional query request parameter tags
  new-optional-request-parameter
Aug 30, 2021c79ea1312eb91See the full diff
- ○
  endpoint added
  endpoint-added
Jun 29, 2021e95a4da3dd7a1See the full diff
- ▲
  api path removed without deprecation
  api-path-removed-without-deprecation
This revision also has 15 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history