---
title: "Translate natural language into a CQL filter expression"
method: POST
path: "/v1/org/{orgId}/ai/translate/expression"
tags: ["ai"]
---

# Translate natural language into a CQL filter expression

`POST /v1/org/{orgId}/ai/translate/expression`

## Path parameters

- `orgId` string, required

## Request body

- AiExpressionTranslateRequest
  - `text` string, required

## Response `200`

successful operation

- AiExpressionTranslateResponse
  - `expression` string, required

## Other responses

- `400` — invalid request
- `401` — not authorized
- `403` — permission denied
- `404` — not found

---

[API](https://skmtc.dev/charthop/apis/charthop-api.md) · [All operations](https://skmtc.dev/charthop/apis/charthop-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/charthop/charthop-api/revisions/0521a07431d4/schema)