---
title: "POST /v1/datasets/{id}/translate-intent"
method: POST
path: "/v1/datasets/{id}/translate-intent"
---

# POST /v1/datasets/{id}/translate-intent

`POST /v1/datasets/{id}/translate-intent`

## Request

- Base URL: `https://api.servicegraph.co`
- URL: `https://api.servicegraph.co/v1/datasets/{id}/translate-intent`
- Auth: HTTP bearer

Translate a plain-English intent into a DSL filter for this dataset. Result includes the LLM-produced filter, a one-sentence reasoning, validity against the dataset's allowed fields, and a sanity-check row count.

## Path parameters

- `id` string, required

## Request body

- object
  - `intent` string, required
  - `model` string

## Response `200`

Default Response

---

[API](https://skmtc.dev/servicegraph/apis/servicegraph-api.md) · [All operations](https://skmtc.dev/servicegraph/apis/servicegraph-api/llms.txt) · [OpenAPI document](https://skmtc.dev/servicegraph/apis/servicegraph-api/revisions/f2f2f945c796?raw)