v1

latestSwagger 2.0raw.githubusercontent.com2022-07-014922.4 KB
Intent

list datasets

Lists datasets containing intents and corresponding phrases. You can choose to list only your own datasets, as well as template datasets, or both. Template datasets are used as examples and can be found under the Templates tab in the dataset overview of the dashboard. You can clone such datasets to kickstart the creation of a dataset that is tailored to your use-case.

Note that the results are paginated and so you might need to iteratively call this endpoint to obtain all your datasets.

get/api/v1/datasets

Query parameters

listMode'ALL' | 'ONLY_TEMPLATE' | 'ONLY_USER'

List mode indicating to query template datasets, only user datasets or both.

  • ALL: List all datasets.
  • ONLY_TEMPLATE: List the template datasets. Template datasets are used as examples and can be found under the Templates tab in the dataset overview of the dashboard. You can clone such datasets to kickstart the creation of a dataset that is tailored to your use-case.
  • ONLY_USER: List the user datasets.
limitinteger

The limit defining the maximal number of datasets to return.

cursorstring

The cursor to view the next paginated collection of datasets as provided by the next_cursor value in the ListDatasetsResponse.

Response

A successful response.

limitinteger

The effective limit of the maximum number of datasets that could be returned by the list endpoint. If the limit defined in ListDatasetsRequest was not set, this value indicates the used limit.

nextCursorstring

The cursor that can be used to obtain the next paginated collection of datasets.

Example response

{
  "datasets": [
    {
      "createdAt": "2021-08-24T12:04:32Z",
      "datasetId": "dde4eeae-7652-4bc8-8be1-1cd6ac898dc7",
      "description": "This dataset is clearly some awesome dataset.",
      "intents": [
        "order",
        "reservation"
      ],
      "isTemplate": false,
      "lastTrainedAt": "2021-08-24T12:04:32Z",
      "name": "My awesome dataset",
      "updatedAt": "2021-08-24T12:04:32Z"
    }
  ],
  "limit": 20,
  "nextCursor": "VGhpcyBpcyBub3QgYSByZWFsIGN1cnNvciwgYnV0IHRoZXkgd291bGQgYmUgYmFzZTY0IGVuY29kZWQgdG9vCg=="
}
All 4 operations