---
title: "Run a Text AI Based Search on Trained Datasets"
method: POST
path: "/api/ai/search/v2"
tags: ["AI Dataset Management"]
---

# Run a Text AI Based Search on Trained Datasets

`POST /api/ai/search/v2`

## Request

- Base URL: `https://api.worqhat.com`
- URL: `https://api.worqhat.com/api/ai/search/v2`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/worqhat/apis/worqhat-ai-api-endpoints-2/docs/api/ai/search/v2/post.ts> (a function with typed inputs; its response is checked against the schema)

Run a Text AI Based Search on Trained Datasets. You can run a Text AI Based Search on Trained Datasets using this endpoint. You can pass in the Dataset ID and the Search Query and we will run the search for you.

## Request body

- object
  - `question` string: The Search Query that you want to search for.
  - `training_data` string: The ID of the Trained Dataset that you want to search in.

## Response `200`

Successful response

- object
  - `status` string: Status indicating the success of the request.
  - `result` object[]
    - `sId` string: The ID of the item.
    - `type` string: The type of the item.
    - `name` string: The name of the item.
    - `ppu` number: The price per unit of the item.
  - `processing_time` integer: The time taken to process the request, in milliseconds.
  - `processing_id` string: A universally unique identifier for the request. This can be used to track the request in the logs.
  - `processing_count` integer: The number of times the request has been processed. This is what is considered in the Billing Process.

## Other responses

- `400`: Bad Request.
- `401`: Unauthorized
- `404`: Not Found
- `406`: Not Acceptable
- `500`: Internal Server Error

## Changes

- **2023-10-20** `871850b7231f`: 4 warning, 16 info
  - removed the optional property `data` from the response with the `200` status
  - removed the optional property `id` from the response with the `200` status
  - removed the optional property `time_taken` from the response with the `200` status
  - removed the optional property `timestamp` from the response with the `200` status
  - …16 more
- **2023-08-15** `b5ffe2a9748f`: 5 breaking, 12 info
  - the response's body type changed from no type to `object` for status `400`
  - the response's body type changed from no type to `object` for status `401`
  - the response's body type changed from no type to `object` for status `404`
  - the response's body type changed from no type to `object` for status `406`
  - …13 more
- **2023-08-04** `be85a8f8fc8c`: 5 breaking, 10 warning
  - the response's body type changed from `object` to no type for status `400`
  - the response's body type changed from `object` to no type for status `401`
  - the response's body type changed from `object` to no type for status `404`
  - the response's body type changed from `object` to no type for status `406`
  - …11 more
- **2023-08-04** `d6dbf089e00d`: 1 info
  - the endpoint scheme security `bearerAuth` was removed from the API
- **2023-08-03** `87a2697d00bf`: 2 info
  - the endpoint scheme security `bearerAuth` was added to the API
  - the endpoint scheme security `ApiKeyAuth AND OrgKeyAuth` was removed from the API

[Operation history](https://skmtc.dev/worqhat/apis/worqhat-ai-api-endpoints-2/changes/api/ai/search/v2/post.md)

---

[API](https://skmtc.dev/worqhat/apis/worqhat-ai-api-endpoints-2.md) - [All operations](https://skmtc.dev/worqhat/apis/worqhat-ai-api-endpoints-2/llms.txt) - [OpenAPI document](https://skmtc.dev/worqhat/apis/worqhat-ai-api-endpoints-2/revisions/fc369f69a3e6?raw)