---
title: "Execute NLP query against a dataset"
method: POST
path: "/api/2.0/nlp/{objectId}/run"
tags: ["Natural Language Processing Management API"]
---

# Execute NLP query against a dataset

`POST /api/2.0/nlp/{objectId}/run`

## Path parameters

- `objectId` integer, required

## Request body

- NlpQuery — NLP query.
  - `query` string — Query string.

## Response `200`

Success

- NlpData — Data from an NLP query
  - `datasetId` integer — Dataset id for the matching dataset from the NLP query.
  - `datasetName` string — Dataset id for the matching dataset from the NLP query.
  - `data` object[]

## Other responses

- `400` — Bad request
- `401` — User is not authenticated
- `403` — User is not allowed to access this resource
- `500` — Error during processing

---

[API](https://skmtc.net/knowi/apis/user-management-api.md) · [All operations](https://skmtc.net/knowi/apis/user-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/knowi/user-management-api/revisions/6e6982573ba6/schema)